As identidades relacionadas em um gráfico de identidade, independentemente do namespace, são consideradas parte do mesmo "cluster" nesse gráfico de identidade. As opções abaixo fornecem o meio de acessar todos os membros do cluster.
Recuperar todos os membros do cluster para uma única identidade.
Você pode usar o graph-type
parâmetro para indicar o gráfico de identidade do qual obter o cluster. As opções são:
graph-type
for fornecido, esse será o padrão.Formato da API
GET https://platform-{REGION}.adobe.io/data/core/identity/cluster/members?{PARAMETERS}
Solicitação
Opção 1: fornecer a identidade como namespace (nsId
, por ID) e valor de ID (id
).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/members?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}'
Opção 2: fornecer a identidade como namespace (ns
, por nome) e valor de ID (id
).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/members?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}'
Opção 3: fornecer a identidade como XID (xid
). Para obter mais informações sobre como obter o XID de uma identidade, consulte a seção deste documento que aborda obter o XID de uma identidade.
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/members?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}'
Uso POST
como um lote equivalente ao GET
método descrito acima para retornar as identidades nos clusters de várias identidades.
A solicitação não deve indicar mais de 1000 identidades. Solicitações que excedem 1000 identidades resultarão em um código de status 400.
Formato da API
POST https://platform-{REGION}.adobe.io/data/core/identity/clusters/members
Solicitação
A solicitação a seguir demonstra o fornecimento de uma lista de XIDs para os quais os membros do cluster serão recuperados.
Solicitação de stub
Uso do x-uis-cst-ctx: stub
o cabeçalho retornará uma resposta com stubbed. Esta é uma solução temporária para facilitar o progresso do desenvolvimento da integração inicial, enquanto os serviços estão sendo concluídos. Isso será descontinuado quando não for mais necessário.
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/members \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-uis-cst-ctx: stub' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"]
}'
Chamar usando XIDs
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/members \
-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
Chamar usando UIDs
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/members \
-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
Resposta
Resposta 'Obstruída'
{
"version": 1,
"clusters": [{
"xid": "GZsBQnHQaGtL46ZKSvO9bNRE1DcUyQA",
"compositeXid": {
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
"members": ["e8138f65-d3d3-4485-a7e1-6712e047349d", "21312343536983537571245438594"],
"members": [{
"nsid": 0,
"id": "27064814400205787570627663430729680462"
},
{
"nsid": 411,
"id": "86826386186182763871263871263876128612"
}
]
},
{
"xid": "CJsDEAMaEAHmCKwPCQYNvzxD9JGDHZ8",
"compositeXid": {
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
"members": [],
"members": []
}
],
"unprocessedXids": ["cb0665db616f49758713252d8a335c1e"],
"unprocessedNids": [{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}]
}
Resposta completa
{
"unprocessedXids": [],
"unprocessedNids": [],
"version": "1.0.0",
"clusters": [{
"xid": "411|WRbM7AAAAJ_PBZHl",
"members": [
"411|WRbM7AAAAJ_PBZHl",
"0|47713142741924778930324734610798294416"
],
"compositeXid": {
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
"members": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 0,
"id": "47713142741924778930324734610798294416"
}
]
},
{
"xid": "411|WY-RNgAAArI4rGBo",
"compositeXid": {
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
"members": [
"411|WY-RNgAAArI4rGBo",
"411|WY-RNgAAArI4rGGy"
],
"members": [{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGGy"
}
]
}
]
}
A resposta sempre terá uma entrada para cada XID fornecido na solicitação, independentemente de os XIDs de uma solicitação pertencerem ao mesmo cluster ou se um ou mais tiverem algum cluster associado.
Prosseguir para o próximo tutorial para listar o histórico de cluster de uma identidade