De Reactor-API verifiëren en openen

Om ​ Reactor API ​ te gebruiken om de uitbreidingen van Codes tot stand te brengen en te beheren, moet elk verzoek de volgende authentificatiekopballen omvatten:

In deze handleiding wordt uitgelegd hoe u de Adobe Developer Console kunt gebruiken om de waarden voor elk van deze kopteksten te verzamelen, zodat u aanroepen kunt starten naar de Reactor-API.

Toegang voor ontwikkelaars tot Adobe Experience Platform gain-developer-access

Voordat u verificatiewaarden voor de Reactor-API kunt genereren, moet u toegang voor ontwikkelaars tot Experience Platform hebben. Om ontwikkelaartoegang te verkrijgen, volg de eerste stappen in het ​ de authentificatieleerprogramma van Experience Platform ​. Zodra u de ​ stap van de Toegang van de Gebruiker van de Versterking ​ hebt voltooid, terugkeer naar dit leerprogramma om de geloofsbrieven te produceren specifiek voor Reactor API.

Toegangsreferenties genereren generate-access-credentials

Met Adobe Developer Console moet u de volgende drie toegangsreferenties genereren:

Identiteitskaart van uw organisatie ({ORG_ID}) en de sleutel van API ({API_KEY}) kunnen in toekomstige API vraag worden opnieuw gebruikt nadat zij aanvankelijk zijn geproduceerd. Nochtans, is uw toegangstoken ({ACCESS_TOKEN}) tijdelijk en moet om de 24 uur worden opnieuw geproduceerd.

De stappen voor het genereren van deze waarden worden hieronder in detail besproken.

Eenmalige installatie one-time-setup

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

Zodra u een project hebt gecreeerd, uitgezocht voeg API op het Overzicht van het Project scherm toe.

voeg API scherm toe verschijnt. Selecteer de Lanceer API van het Platform van de Ervaring van de lijst van beschikbare APIs alvorens daarna te selecteren.

Selecteer vervolgens het verificatietype dat u wilt genereren voor toegangstokens en toegang tot de Experience Platform API.

Selecteer daarna om verder te gaan.

In het volgende scherm wordt u gevraagd een of meer productprofielen te selecteren die u aan de API-integratie wilt koppelen.

Selecteer de gewenste productprofielen van de lijst, dan uitgezocht sparen gevormde API om de API registratie te voltooien.

Referenties verzamelen gather-credentials

Zodra API aan het project is toegevoegd, Experience Platform API 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.

U hebt twee opties om uw toegangstokens te produceren, afhankelijk van uw gebruiksgeval:

Handmatig toegangstekens genereren manual

Als u handmatig een nieuwe {ACCESS_TOKEN} wilt genereren, navigeert u naar Credentials > OAuth Server-to-Server en selecteert u Generate access token (zie hieronder).

Er wordt een nieuw toegangstoken gegenereerd en er wordt een knop opgegeven waarmee het token naar het klembord kan worden gekopieerd. Deze waarde wordt gebruikt voor de vereiste machtigingsheader en moet worden opgegeven in de indeling Bearer {ACCESS_TOKEN} .

Automatisch token genereren auto-token

U kunt ook een Postman-omgeving en -verzameling gebruiken om toegangstokens te genereren. Voor meer informatie, lees de sectie over ​ gebruikend Postman om API vraag ​ in de de authentificatiegids van Experience Platform voor authentiek te verklaren en te testen API.

API-referenties testen test-api-credentials

Door de stappen in deze zelfstudie uit te voeren, hebt u geldige waarden voor {ORG_ID}, {API_KEY} en {ACCESS_TOKEN} . U kunt deze waarden nu testen door ze te gebruiken in een eenvoudig cURL-verzoek aan de Reactor-API.

Begin door te proberen om een API vraag te maken aan ​ lijst alle bedrijven ​.

Nadat u hebt bevestigd dat uw toegangsreferenties werken, gaat u verder met de documentatie van de andere API-naslaggids om de vele mogelijkheden van de API te leren kennen.

API-voorbeeldaanroepen lezen read-sample-api-calls

Elke eindpuntgids verstrekt voorbeeld API vraag om aan te tonen hoe te om uw verzoeken te formatteren. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de overeenkomsten die in documentatie voor steekproef API vraag worden gebruikt, zie de sectie op ​ hoe te om voorbeeld API vraag ​ in de begonnen gids voor Experience Platform APIs te lezen.

Volgende stappen next-steps

Nu u begrijpt welke kopballen aan gebruik, bent u bereid beginnen het richten aan Reactor API. Selecteer een van de eindpunthulplijnen om aan de slag te gaan: