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.

NOTE
Begäran får inte innehålla fler än 1 000 identiteter. Begäranden som överskrider 1 000 identiteter resulterar i 400-statuskod.

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: Anger regionId och lastAssociationTime för var identiteten sågs.

Nästa steg

Gå till nästa självstudiekurs för att visa tillgängliga namnutrymmen.

recommendation-more-help
64963e2a-9d60-4eec-9930-af5aa025f5ea