Experience Platform-API's verifiëren en openen
Dit document biedt een stapsgewijze zelfstudie voor het verkrijgen van toegang tot een Adobe Experience Platform-ontwikkelaarsaccount om aanroepen uit te voeren naar Experience Platform-API's. Aan het einde van deze zelfstudie hebt u de volgende gegevens gegenereerd of verzameld die als headers zijn vereist voor alle API-aanroepen van het platform:
{ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
{SANDBOX_NAME}
te verstrekken als koptekst. Zie de sandboxen, overzicht voor meer informatie over sandboxen en de sandboxbeheereindpunt documentatie voor informatie over het vermelden van de zandbakken beschikbaar aan uw organisatie.Om de veiligheid van uw toepassingen en gebruikers te handhaven, moeten alle verzoeken aan Experience Platform APIs worden voor authentiek verklaard en worden gemachtigd gebruikend normen zoals OAuth.
In deze zelfstudie wordt uitgelegd hoe u de vereiste referenties kunt verzamelen voor het verifiëren van API-aanroepen van het platform, zoals hieronder in het stroomschema wordt beschreven. U kunt de meeste vereiste geloofsbrieven in eerste éénmalige opstelling verzamelen. Het toegangstoken, echter, moet om de 24 uur worden verfrist.
Vereisten prerequisites
Om met succes vraag aan Experience Platform APIs te maken, moet u het volgende hebben:
- Een organisatie met toegang tot Adobe Experience Platform.
- Een beheerder van de Admin Console die u als ontwikkelaar en gebruiker voor een productprofiel kan toevoegen.
- Een systeembeheerder van het Experience Platform die u de noodzakelijke attribuut gebaseerde toegangscontroles kan verlenen om gelezen uit te voeren of verrichtingen op verschillende delen van Experience Platform door APIs te schrijven.
U moet ook over een Adobe ID beschikken om deze zelfstudie te voltooien. Als u geen Adobe ID hebt, kunt u er een maken door de volgende stappen uit te voeren:
- Ga naar Adobe Developer Console.
- Selecteer Create a new account.
- Voltooi het aanmeldingsproces.
De ontwikkelaar van de winst en gebruikerstoegang voor Experience Platform gain-developer-user-access
Voordat u integratie in Adobe Developer Console kunt maken, moet uw account ontwikkelings- en gebruikersmachtigingen hebben voor een productprofiel voor een Experience Platform in Adobe Admin Console.
Toegang voor ontwikkelaars verkrijgen gain-developer-access
Contact opnemen met Admin Console beheerder in uw organisatie om u als ontwikkelaar aan een het productprofiel van het Experience Platform toe te voegen gebruikend Admin Console. Zie de Admin Console documentatie voor specifieke instructies over hoe te toegang voor ontwikkelaars beheren voor productprofielen.
Als u eenmaal als ontwikkelaar bent toegewezen, kunt u beginnen met het maken van integratie in Adobe Developer Console. Deze integratie vormt een pijplijn van externe apps en services naar Adobe-API's.
Toegang tot gebruikers verkrijgen gain-user-access
Uw Admin Console beheerder moet u ook als gebruiker toevoegen aan hetzelfde productprofiel. Met gebruikerstoegang, kunt u in UI het resultaat van de API verrichtingen zien die u uitvoert.
Zie de handleiding op gebruikersgroepen beheren in Admin Console voor meer informatie .
Een API-sleutel (client-id) en organisatie-id genereren generate-credentials
Nadat u ontwikkelaars en gebruikers toegang tot Platform door hebt gegeven Admin ConsoleDe volgende stap bestaat uit het genereren van uw {ORG_ID}
en {API_KEY}
referenties in Adobe Developer Console. Deze geloofsbrieven moeten slechts eenmaal worden geproduceerd en kunnen in toekomstige vraag van Platform API worden opnieuw gebruikt.
Experience Platform toevoegen aan een project add-platform-to-project
Ga naar Adobe Developer Console en meld u aan met uw Adobe ID. Voer vervolgens de stappen uit die in de zelfstudie worden beschreven een leeg project maken in de Adobe Developer Console-documentatie.
Als u een nieuw project hebt gemaakt, selecteert u Add API op de Project Overview scherm.
De Add an API wordt weergegeven. Selecteer het productpictogram voor Adobe Experience Platform en kies Experience Platform API voordat u selecteert Next.
Selecteer het verificatietype OAuth Server-to-Server select-oauth-server-to-server
Selecteer vervolgens het verificatietype dat u wilt maken voor het genereren van toegangstokens en voor toegang tot de Experience Platform-API.
Selecteer de productprofielen voor uw integratie select-product-profiles
In de Configure API scherm, selecteren AEP-Default-All-Users.
Selecteren Save configured API wanneer u klaar bent.
In de onderstaande videozelfstudie vindt u een analyse van de hierboven beschreven stappen voor het instellen van integratie met de Experience Platform-API:
Referenties verzamelen gather-credentials
Zodra API aan het project is toegevoegd, Experience Platform API De pagina voor het project toont de volgende geloofsbrieven die in alle vraag aan Experience Platform APIs worden vereist:
{API_KEY}
(Client ID){ORG_ID}
(Organization ID)
Een toegangstoken genereren generate-access-token
De volgende stap bestaat uit het genereren van een {ACCESS_TOKEN}
referentie voor gebruik in platform API vraag. In tegenstelling tot de waarden voor {API_KEY}
en {ORG_ID}
moet om de 24 uur een nieuw token worden gegenereerd om door te gaan met het gebruik van platform-API's. Selecteren Generate access token, zoals hieronder weergegeven.
[Vervangen]{class="badge negative"} Een JSON-webtoken (JWT) genereren jwt
De volgende stap bestaat uit het genereren van een JSON Web Token (JWT) op basis van uw accountgegevens. Deze waarde wordt gebruikt om uw {ACCESS_TOKEN}
referentie voor gebruik in API-aanroepen van Platform, die elke 24 uur opnieuw moet worden gegenereerd.
note important |
---|
IMPORTANT |
In deze zelfstudie wordt in de onderstaande stappen beschreven hoe u een JWT kunt genereren in de Developer Console. Deze generatiemethode mag echter alleen voor test- en evaluatiedoeleinden worden gebruikt. |
Voor normaal gebruik moet de JWT automatisch worden gegenereerd. Voor meer informatie over hoe te om JWTs programmatically te produceren, zie servicerekeningautorisatiehandleiding op Adobe Developer. |
Selecteren Service Account (JWT) in de linkernavigatie selecteert u vervolgens Generate JWT.
In het tekstvak onder Generate custom JWT plakken, plakt u de inhoud van de persoonlijke sleutel die u eerder hebt gegenereerd toen u de Platform-API aan uw serviceaccount toevoegde. Selecteer vervolgens Generate Token.
De pagina wordt bijgewerkt om de gegenereerde JWT weer te geven, samen met een voorbeeld-URL-opdracht waarmee u een toegangstoken kunt genereren. In deze zelfstudie selecteert u Copy naast Generated JWT om het token naar het klembord te kopiëren.
Een toegangstoken genereren
Nadat u een JWT hebt gegenereerd, kunt u deze gebruiken in een API-aanroep om uw {ACCESS_TOKEN}
. In tegenstelling tot de waarden voor {API_KEY}
en {ORG_ID}
moet om de 24 uur een nieuw token worden gegenereerd om door te gaan met het gebruik van platform-API's.
Verzoek
Met de volgende aanvraag wordt een nieuwe {ACCESS_TOKEN}
op basis van de gegevens die in de payload zijn opgegeven. Dit eindpunt keurt vormgegevens slechts als zijn lading goed, en daarom moet het worden gegeven Content-Type
header van multipart/form-data
.
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
Eigenschap | Beschrijving |
{API_KEY} |
De {API_KEY} (Client ID) die u in een vorige stap. |
{SECRET} |
Het clientgeheim dat u hebt opgehaald in een vorige stap. |
{JWT} |
De JWT die u in een vorige stap. |
note note |
---|
NOTE |
U kunt dezelfde API-sleutel, clientgeheim en JWT gebruiken om een nieuw toegangstoken voor elke sessie te genereren. Hierdoor kunt u het genereren van toegangstoken in uw toepassingen automatiseren. |
Antwoord
code language-json |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
Eigenschap | Beschrijving |
token_type |
Het type of token dat wordt geretourneerd. Deze waarde is altijd voor toegangstokens bearer . |
access_token |
De gegenereerde {ACCESS_TOKEN} . Deze waarde, voorafgegaan door het woord Bearer is vereist als de Authentication header voor alle API-aanroepen van Platform. |
expires_in |
Het aantal milliseconden dat resteert tot het toegangstoken verloopt. Zodra deze waarde 0 bereikt, moet een nieuw toegangstoken worden geproduceerd om het blijven gebruiken van Platform APIs. |
Toegangsreferenties testen test-credentials
Nadat u alle drie vereiste gegevens hebt verzameld (toegangstoken, API-sleutel en organisatie-id), kunt u de volgende API-aanroep proberen te maken. Deze vraag maakt een lijst van alle norm Experience Data Model (XDM) klassen beschikbaar aan uw organisatie. De invoer en voert de vraag binnen uit Postman.
Verzoek
curl -X GET https://platform.adobe.io/data/foundation/schemaregistry/global/classes \
-H 'Accept: application/vnd.adobe.xed-id+json' \
-H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
-H 'x-api-key: {{API_KEY}}' \
-H 'x-gw-ims-org-id: {{ORG_ID}}'
Antwoord
Als uw reactie vergelijkbaar is met de hieronder weergegeven reactie, zijn uw gegevens geldig en werken ze. (Deze reactie is afgebroken voor de ruimte.)
{
"results": [
{
"title": "XDM ExperienceEvent",
"$id": "https://ns.adobe.com/xdm/context/experienceevent",
"meta:altId": "_xdm.context.experienceevent",
"version": "1"
},
{
"title": "XDM Individual Profile",
"$id": "https://ns.adobe.com/xdm/context/profile",
"meta:altId": "_xdm.context.profile",
"version": "1"
}
]
}
Krijg de noodzakelijke op attributen-gebaseerde toegangsbeheertoestemmingen get-abac-permissions
Om tot verscheidene middelen binnen Experience Platform toegang te hebben of te wijzigen, moet u de aangewezen toestemmingen van de toegangscontrole hebben. Systeembeheerders kunnen u de machtigingen die u nodig hebt. Meer informatie vindt u in de sectie over het beheren van API geloofsbrieven voor een rol.
De gedetailleerde informatie over hoe een systeembeheerder de vereiste toestemmingen kan verlenen om tot de middelen van het Platform via API toegang te hebben is ook beschikbaar in de videozelfstudie hieronder:
Postman gebruiken om API-aanroepen te verifiëren en te testen use-postman
Postman is een populair hulpmiddel dat ontwikkelaars toestaat om RESTful APIs te onderzoeken en te testen. U kunt Experience Platform Postman-verzamelingen en -omgevingen gebruiken om uw werk met Experience Platform-API's te versnellen. Meer informatie over Postman gebruiken in Experience Platform en aan de slag gaan met verzamelingen en omgevingen.
Gedetailleerde informatie over het gebruik van Postman met verzamelingen Experience Platforms en omgevingen is ook beschikbaar in de onderstaande videozelfstudies:
Een Postman-omgeving downloaden en importeren voor gebruik met Experience Platform-API's
Een Postman-verzameling gebruiken om toegangstokens te genereren
Download de Identity Management Service Postman collection en bekijk de video hieronder om te leren hoe te om toegangstokens te produceren.
Postman-verzamelingen voor Experience Platform-API downloaden en communiceren met de API's
Systeembeheerders: toegangsbeheer voor ontwikkelaars en API's verlenen met machtigingen voor Experience Platforms grant-developer-and-api-access-control
Voordat u integratie in Adobe Developer Console kunt maken, moet uw account ontwikkelings- en gebruikersmachtigingen hebben voor een productprofiel voor een Experience Platform in Adobe Admin Console.
Ontwikkelaars toevoegen aan productprofiel add-developers-to-product-profile
Ga naar Admin Console en meld u aan met uw Adobe ID.
Selecteren Products selecteert u vervolgens Adobe Experience Platform in de lijst van producten.
Selecteer op het tabblad Product Profiles de optie AEP-Default-All-Users. U kunt ook de zoekbalk gebruiken om het productprofiel te zoeken door de naam in te voeren.
Selecteer de Developers tab, dan selecteren Add Developer.
Voer de Email or username. Een geldige Email or username geeft de ontwikkelaardetails weer. Selecteer Save.
De ontwikkelaar is toegevoegd en wordt weergegeven op het tabblad Developers tab.
API aan een rol toewijzen
Een systeembeheerder kan APIs aan rollen in het Experience Platform UI toewijzen.
Selecteren Permissions en de rol waaraan u de API wilt toevoegen. Selecteer de API credentials tab, dan selecteren Add API credentials.
Selecteer de API die u aan de rol wilt toevoegen en selecteer Save.
U bent teruggekeerd aan API credentials , waarin de nieuw toegevoegde API wordt weergegeven.
Aanvullende bronnen additional-resources
Raadpleeg de aanvullende bronnen die hieronder zijn gekoppeld voor meer hulp bij het starten met Experience Platform-API's
- API's van Experience Platforms verifiëren en openen pagina met videozelfstudies
- Identity Management Service Postman Collection voor het genereren van toegangstokens
- Experience Platform API Postman-verzamelingen
Volgende stappen next-steps
Door dit document te lezen, hebt u uw toegangsreferenties voor platform-API's verzameld en getest. U kunt nu de voorbeeld-API-aanroepen volgen die via de documentatie.
Naast de authentificatiewaarden u in dit leerprogramma hebt verzameld, vereisen vele Platform APIs ook een geldig {SANDBOX_NAME}
te verstrekken als koptekst. Zie het sandboxoverzicht voor meer informatie.