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 Experience Platform API-aanroepen:

Om de veiligheid van uw toepassingen en gebruikers te handhaven, moeten alle verzoeken aan Experience Platform APIs voor authentiek worden 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 Experience Platform API-aanroepen, 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

Als u aanroepen naar Experience Platform API's wilt uitvoeren, moet u over het volgende beschikken:

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:

Profiteer van toegang voor ontwikkelaars en gebruikers van Experience Platform gain-developer-user-access

Voordat u integratie op Adobe Developer Console kunt maken, moet uw account ontwikkelings- en gebruikersmachtigingen hebben voor een Experience Platform-productprofiel in Adobe Admin Console.

Toegang voor ontwikkelaars verkrijgen gain-developer-access

Neem contact op met een Admin Console-beheerder in uw organisatie om u als ontwikkelaar toe te voegen aan een Experience Platform-productprofiel. Zie de documentatie van Admin Console voor specifieke instructies op hoe te ontwikkelaartoegang voor productprofielenbeheren.

Zodra u als ontwikkelaar wordt toegewezen, kunt u beginnen integraties in Adobe Developer Consoletot stand te brengen. Deze integratie is 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 gids op het leiden gebruikersgroepen in Admin Consolevoor meer informatie.

Een API-sleutel (client-id) en organisatie-id genereren generate-credentials

Nadat u ontwikkelaars en gebruikers via Admin Console toegang hebt verleend tot Experience Platform, bestaat de volgende stap uit het genereren van uw {ORG_ID} - en {API_KEY} -referenties in Adobe Developer Console. Deze gegevens hoeven slechts eenmaal te worden gegenereerd en kunnen in toekomstige Experience Platform API-aanroepen opnieuw worden gebruikt.

Experience Platform toevoegen aan een project add-platform-to-project

Ga naar Adobe Developer Consoleen teken binnen met uw Adobe ID. Daarna, volg de stappen die in het leerprogramma worden geschetst op creërend een leeg projectin de documentatie van Adobe Developer Console.

Wanneer u een nieuw project hebt gemaakt, selecteert u Add API op het Project Overview -scherm.

Het scherm Add an API wordt weergegeven. Selecteer het productpictogram voor Adobe Experience Platform en kies Experience Platform API voordat u Next selecteert.

Selecteer het verificatietype OAuth Server-to-Server select-oauth-server-to-server

Selecteer vervolgens het verificatietype OAuth Server-to-Server dat u wilt gebruiken voor het genereren van toegangstokens en het openen van de Experience Platform API. Geef uw referentie een betekenisvolle naam in het tekstveld Credential name voordat u Next selecteert.

Selecteer de productprofielen voor uw integratie select-product-profiles

Selecteer in het scherm Configure API de optie AEP-Default-All-Users , samen met eventuele aanvullende productprofielen waartoe u toegang wilt krijgen.

Selecteer 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, OAuth Server-to-Server toont de pagina voor het project de volgende geloofsbrieven die in alle vraag aan Experience Platform APIs worden vereist:

Een toegangstoken genereren generate-access-token

De volgende stap bestaat uit het genereren van een {ACCESS_TOKEN} -referentie voor gebruik in Experience Platform API-aanroepen. In tegenstelling tot de waarden voor {API_KEY} en {ORG_ID} , moet om de 24 uur een nieuw token worden gegenereerd om Experience Platform API's te kunnen blijven gebruiken. Selecteer Generate access token die het toegangstoken produceert, zoals hieronder wordt getoond.

te produceren

Verificatiegegevens rechtstreeks in de API-naslagdocumentatie maken en ophalen get-credentials-functionality

Vanaf de release van november 2024 van Experience Platform kunt u referenties ophalen om de Experience Platform API's rechtstreeks vanaf de API-referentiepagina's te gebruiken, zonder dat u naar Developer Console hoeft te gaan. Bekijk het voorbeeld hieronder van de Dienst API van de Stroom - de pagina van Doelen.

Als u referenties wilt ophalen om Experience Platform API's aan te roepen, navigeert u naar een willekeurige Experience Platform API-referentiepagina en selecteert u Sign in boven aan de pagina. Meld u aan met uw Personal Account of Company or School Account .

Nadat u zich hebt aangemeld, selecteert u Create new credential om een nieuwe set referenties te maken voor toegang tot Experience Platform API's.

Gebruik vervolgens de keuzelijst om het venster met referenties te openen, een toegangstoken te genereren en uw API-sleutel en organisatie-id op te halen. Kopieer de referenties naar de blokken Try it op de API-referentiepagina's om te gaan werken met Experience Platform API's.

[​ Vervangen ​]{class="badge informative"} {type=negative} produceer een Symbolisch van het Web JSON (JWT) jwt

curl -X POST https://ims-na1.adobelogin.com/ims/exchange/jwt \
  -H 'Content-Type: multipart/form-data' \
  -F 'client_id={API_KEY}' \
  -F 'client_secret={SECRET}' \
  -F 'jwt_token={JWT}'

{
  "token_type": "bearer",
  "access_token": "{ACCESS_TOKEN}",
  "expires_in": 86399992
}

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 standaard Experience Data Model (XDM) klassen beschikbaar aan uw organisatie. De invoer en voert de vraag in Postmanuit.

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}}'

Reactie

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 toegangsbeheertoestemmingen hebben. De beheerders van het systeem kunnen u de toestemmingen verlenen unodig hebt. Krijg meer informatie in de sectie over het leiden API geloofsbrieven voor een rol.

Gedetailleerde informatie over hoe een systeembeheerder de vereiste machtigingen voor toegang tot Experience Platform-bronnen via de API kan verlenen, is ook beschikbaar in de onderstaande videozelfstudie:

Postman gebruiken om API-aanroepen te verifiëren en te testen use-postman

Postmanis een populair hulpmiddel dat ontwikkelaars toestaat om RESTful APIs te onderzoeken en te testen. Met Experience Platform Postman-verzamelingen en -omgevingen kunt u uw werk versnellen met Experience Platform API's. Lees meer over het gebruiken van Postman in Experience Platformen het worden begonnen met inzamelingen en milieu's.

Gedetailleerde informatie over het gebruik van Postman met Experience Platform-verzamelingen en -omgevingen is ook beschikbaar in de volgende videozelfstudies:

Download en voer een milieu van Postman in om met Experience Platform APIs te gebruiken

Gebruik een inzameling van Postman om toegangstokens te produceren

Download de inzameling van Postman van de Dienst van Identity Managementen bekijk de video hieronder om te leren hoe te om toegangstokens te produceren.

de inzamelingen van Experience Platform API Postman van de Download en interactie met APIs

Systeembeheerders: toegangsbeheer voor ontwikkelaars en API's verlenen met Experience Platform-machtigingen grant-developer-and-api-access-control

Voordat u integratie op Adobe Developer Console kunt maken, moet uw account ontwikkelings- en gebruikersmachtigingen voor een Experience Platform-productprofiel hebben.

Ontwikkelaars toevoegen aan productprofiel add-developers-to-product-profile

Navigeer aan Admin Consoleen teken binnen met uw Adobe ID.

Selecteer Products op de navigatiebalk en selecteer vervolgens Adobe Experience Platform in de lijst met 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 tab Developers en selecteer vervolgens Add Developer .

Het dialoogvenster Add developers wordt weergegeven. Voer de naam Email or username van de ontwikkelaar in. Een geldige Email or username geeft de details van de ontwikkelaar weer. Selecteer Save.

De ontwikkelaar is toegevoegd en wordt weergegeven op het tabblad Developers .

API-referenties toewijzen aan een rol

Als een systeembeheerder bewerkingen op Experience Platform API's wil gebruiken en uitvoeren, moet hij de API-referenties toevoegen naast de machtigingen die een rol heeft gegeven. Krijg meer informatie in de sectie over het leiden API geloofsbrieven voor een rol.

Een analyse van de hierboven beschreven stappen voor het toevoegen van ontwikkelaars aan productprofielen en het toewijzen van APIs aan rollen is ook beschikbaar in de videozelfstudie hieronder:

Aanvullende bronnen additional-resources

Raadpleeg de aanvullende bronnen die hieronder zijn gekoppeld voor meer hulp bij het starten met Experience Platform API's

Volgende stappen next-steps

Door dit document te lezen, hebt u uw toegangsgegevens voor Experience Platform API's verzameld en getest. U kunt nu samen met de voorbeeld API vraag volgen die door de documentatiewordt verstrekt.

Naast de verificatiewaarden die u in deze zelfstudie hebt verzameld, vereisen veel Experience Platform API's ook een geldig {SANDBOX_NAME} dat als koptekst moet worden opgegeven. Zie het sandboxoverzicht voor meer informatie.