Las identidades pueden mover clústeres en el transcurso de varias ejecuciones de gráficos de dispositivos. Identity Service proporciona visibilidad de las asociaciones de clúster de una identidad determinada a lo largo del tiempo.
Utilizar opcional graph-type
para indicar el tipo de salida del que se va a obtener el clúster. Las opciones son:
None
- No realice ninguna vinculación de identidad.Private Graph
: realice la vinculación de identidad en función de su gráfico de identidad privada. Si no graph-type
se proporciona, este es el valor predeterminado.Formato de API
GET https://platform-{REGION}.adobe.io/data/core/identity/cluster/history
Solicitud
Opción 1: Proporcione la identidad como área de nombres (nsId
, por ID) y el valor de ID (id
).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/history?nsId=411&id=WTCpVgAAAFq14FMF' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Opción 2: Proporcione la identidad como área de nombres (ns
, por nombre) y el valor de ID (id
).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/history?ns=AMO&id=WTCpVgAAAFq14FMF' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Opción 3: proporcionar la identidad como XID (xid
). Para obtener más información sobre cómo obtener el XID de una identidad, consulte la sección de este documento que trata obtención del XID de una identidad.
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/history?xid=CJsDEAMaEAHmCKwPCQYNvzxD9JGDHZ8' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Utilice el POST
como equivalente de lote del método GET
método descrito anteriormente para devolver los historiales de clúster de varias identidades.
La solicitud no debe indicar más de 1000 identidades. Las solicitudes que superen las 1000 identidades resultarán en 400 códigos de estado.
Formato de API
POST https://platform-va7.adobe.io/data/core/identity/clusters/history
Cuerpo de la solicitud
Opción 1: proporcione una lista de XID para los que recuperar miembros del clúster.
{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"],
"graph-type": "Private Graph"
}
Opción 2: Proporcione una lista de identidades como ID compuestos, donde cada una de ellas asigna un nombre al valor de ID y al área de nombres por código de área de nombres.
{
"compositeXids": [{
"ns": "AdCloud",
"id": "WRbM7AAAAJ_PBZHl"
},
{
"ns": "AddCloud",
"id": "WY-RNgAAArI4rGBo"
}
]
}
Solicitud
Solicitud de código auxiliar
Uso de x-uis-cst-ctx: stub
el encabezado devolverá una respuesta con un stub. Se trata de una solución temporal para facilitar el progreso temprano del desarrollo de la integración, mientras se completan los servicios. Esto quedará obsoleto cuando ya no sea necesario.
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/history \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'x-uis-cst-ctx: stub' \
-d '{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"],
"graph-type": "Private Graph"
}'
Uso de XID
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/history \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"],
"graph-type": "Private Graph"
}' | json_pp
Uso de UID
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/history \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"compositeXids": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}
],
"graph-type": "Private Graph"
}' | json_pp
Responder
{
"version": 1,
"xidsClusterHistory": [{
"xid": "GZsBQnHQaGtL46ZKSvO9bNRE1DcUyQA",
"compositeXid": {
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
"clusterHistory": [{
"clusterId": "4c686f23-0871-41c2-b4f4-adef89f6bd2c",
"cRecordedTS": "1504741401382"
},
{
"clusterId": "29bf066c-971a-11e7-abc4-cec278b6b50a",
"cRecordedTS": "1502063001629"
},
{
"clusterId": "aeb2f60c-b0f1-446a-91dd-d28ab6a44ff9",
"cRecordedTS": "1499384601763"
}
]
},
{
"xid": "CJsDEAMaEAHmCKwPCQYNvzxD9JGDHZ8",
"compositeXid": {
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
"clusterHistory": [{
"clusterId": "4c686f23-0871-41c2-b4f4-adef89f6bd2c",
"cRecordedTS": "1504741401937"
}]
}
],
"unprocessedXids": ["cb0665db616f49758713252d8a335c1e"],
"unprocessedNids": [{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}]
}
La respuesta siempre tendrá una entrada para cada XID proporcionado en la solicitud, independientemente de si los XID de una solicitud pertenecen al mismo clúster o si uno o más tienen algún clúster asociado.
Continúe con el siguiente tutorial para enumerar asignaciones de identidad