Visa identitetsmappningar
En mappning är en samling med alla identiteter i ett kluster, för ett angivet namnområde.
Hämta en identitetsmappning för en enskild identitet
Om en identitet anges hämtar du alla relaterade identiteter från samma namnområde som representeras av identiteten i begäran.
API-format
GET https://platform-{REGION}.adobe.io/data/core/identity/mapping
Begäran
Alternativ 1: Ange identiteten som namnområde (nsId
, efter ID) och ID-värde (id
).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?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}'
Alternativ 2: Ange identiteten som namnutrymme (ns
, efter namn) och ID-värde (id
).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?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}'
Alternativ 3: Ange identiteten som XID (xid
). Mer information om hur du hämtar en identitets XID finns i det här dokumentets avsnitt som handlar om hämtning av ett XID för en identitet.
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?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}'
Hämta identitetsmappningar för flera identiteter
Använd metoden POST
som en gruppmotsvarighet till metoden GET
som beskrivs ovan för att hämta mappningar för flera identiteter.
API-format
POST https://platform.adobe.io/data/core/identity/mappings
Begär brödtext
Alternativ 1: Ange en lista med XID:n som mappningar ska hämtas för.
{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"],
"graph-type": "Private Graph"
}
Alternativ 2: Ange en lista över identiteter som sammansatta ID:n, där varje namn anger ID-värdet och namnutrymmet efter namnområdes-ID. I det här exemplet visas hur du använder den här metoden när du skriver över standardvärdet graph-type
för Privat diagram.
{
"compositeXids": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}
],
"graph-type": "None"
}
Begäran
Använda XID
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/mappings \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: 111111@AdobeOrg' \
-d '{
"xids": ["GesCQXX0CAESEE8wHpswUoLXXmrYy8KBTVgA"],
"targetNs": "0",
"graph-type": "Private Graph"
}' | json_pp
Använder UID
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/mappings \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: 111111@AdobeOrg' \
-d '{
"compositeXids": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}
],
"targetNs": "0",
"graph-type": "Private Graph"
}' | json_pp
Om inga relaterade identiteter hittades med angivna indata returneras en HTTP 204
-svarskod utan innehåll.
Svar
{
"version": 1,
"mappings": [{
"xid": "CAESEPl1uYyma1kMDWxx7dhbwGo",
"mapping": [{
"xid": "81218968060697815473313992060878182012",
"lastAssociationTime": "1493310475047"
}],
"compositeXid": {
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
"mapping": [{
"compositeXid": {
"nsid": 411,
"id": "WY-RNchvdsTSJS"
},
"lastAssociationTime": "1493310475047"
}],
"regions": [{
"regionId": "10",
"lastAssociationTime": "1493310475047"
}]
}],
"unprocessedXids": ["cb0665db616f49758713252d8a335c1e"],
"unprocessedNids": [{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}]
}
lastAssociationTime
: Tidsstämpeln när indataidentiteten senast associerades med den här identiteten.regions
: AngerregionId
ochlastAssociationTime
för var identiteten sågs.
Nästa steg
Gå till nästa självstudiekurs för att visa tillgängliga namnutrymmen.