Autentisera och få åtkomst till Privacy Services-API
Den här guiden ger en introduktion till de centrala koncept du måste känna till innan du försöker ringa anrop till Adobe Experience Platform Privacy Service API.
Förutsättningar prerequisites
Den här guiden kräver en fungerande förståelse av Privacy Service och hur det gör det möjligt att hantera förfrågningar från registrerade (kunder) i olika Adobe Experience Cloud-program.
För att kunna skapa åtkomstautentiseringsuppgifter för API:t måste en administratör i organisationen tidigare ha konfigurerat produktprofiler för Privacy Service inom Adobe Admin Console. Den produktprofil som du tilldelar en API-integrering avgör vilka behörigheter som integreringen har för att komma åt Privacy Servicens funktioner. Se guiden på hantera behörigheter för Privacy Service för mer information.
Samla in värden för obligatoriska rubriker gather-values-required-headers
För att kunna anropa Privacy Service-API:t måste du först samla in dina inloggningsuppgifter och använda dem i obligatoriska rubriker:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Dessa värden genereras med Adobe Developer Console. Dina {ORG_ID}
och {API_KEY}
behöver bara genereras en gång och kan återanvändas i framtida API-anrop. Men {ACCESS_TOKEN}
är tillfälligt och måste genereras om var 24:e timme.
Stegen för att generera dessa värden beskrivs närmare nedan.
Engångskonfiguration one-time-setup
Gå till Adobe Developer Console och logga in med din Adobe ID. Följ sedan instruktionerna i självstudiekursen på skapa ett tomt projekt i Developer Console-dokumentationen.
När du har skapat ett nytt projekt väljer du Add to Project och välja API i listrutan.
Markera Privacy Service-API:t select-privacy-service-api
The Add an API visas. Välj Experience Cloud om du vill begränsa listan med tillgängliga API:er väljer du kort för Privacy Service API före markering Next.
Välj sedan autentiseringstypen för att generera åtkomsttoken och få åtkomst till Privacy Service-API:t.
Tilldela behörigheter via produktprofiler product-profiles
Det sista konfigurationssteget är att välja de produktprofiler som den här integreringen ska ärva sina behörigheter från. Om du väljer mer än en profil kombineras deras behörighetsgrupper för integreringen.
När du är klar väljer du Save configured API.
När API:t har lagts till i projektet Privacy Service API På projektsidan visas följande autentiseringsuppgifter som krävs för alla anrop till API:er för Privacy Service:
{API_KEY}
(Client ID){ORG_ID}
(Organization ID)
Autentisering för varje session authentication-each-session
Den sista obligatoriska autentiseringsuppgifterna som du måste samla in är din {ACCESS_TOKEN}
, som används i auktoriseringshuvudet. Till skillnad från värdena för {API_KEY}
och {ORG_ID}
måste en ny token genereras var 24:e timme för att du ska kunna fortsätta använda API:t.
I allmänhet finns det två metoder för att generera en åtkomsttoken:
- Generera token manuellt för testning och utveckling.
- Automatisera generering av token för API-integreringar.
Generera en token manuellt manual-token
Generera en ny {ACCESS_TOKEN}
, navigera till Credentials > OAuth Server-to-Server och markera Generate access token, vilket visas nedan.
En ny åtkomsttoken genereras och en knapp för att kopiera token till Urklipp tillhandahålls. Det här värdet används för det obligatoriska Authorization och måste anges i formatet Bearer {ACCESS_TOKEN}
.
Automatisera generering av token auto-token
Du kan också använda en Postman-miljö och en samling för att generera åtkomsttoken. Läs mer om använda Postman för att autentisera och testa API-anrop i autentiseringsguiden för Experience Platform API.
Läser exempel-API-anrop read-sample-api-calls
Varje slutpunktshandbok innehåller exempel på API-anrop som visar hur du formaterar dina begäranden. Det kan vara sökvägar, obligatoriska rubriker och korrekt formaterade begärandenyttolaster. Ett exempel på JSON som returneras i API-svar finns också. Information om konventionerna som används i dokumentationen för exempel-API-anrop finns i avsnittet om läsa exempel-API-anrop i komma igång-guiden för Platform API:er.
Nästa steg next-steps
Nu när du förstår vilka rubriker du ska använda kan du börja ringa anrop till Privacy Service-API:t. Välj någon av slutpunktsguiderna för att komma igång: