De Reactor-API verifiëren en openen
Voor het gebruik van de Reactor-API om de uitbreidingen van Codes tot stand te brengen en te beheren, moet elk verzoek de volgende authentificatiekopballen omvatten:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
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 ontwikkelaarstoegang tot het Experience Platform hebben. Volg de eerste stappen in het dialoogvenster Zelfstudie over verificatie van Experience Platforms. Als u de Toegang van gebruikers verkrijgen stap terug naar deze zelfstudie om de referenties te genereren die specifiek zijn voor de Reactor-API.
Toegangsreferenties genereren generate-access-credentials
Met Adobe Developer Console moet u de volgende drie toegangsreferenties genereren:
{ORG_ID}
{API_KEY}
{ACCESS_TOKEN}
De id van uw organisatie ({ORG_ID}
) en API-sleutel ({API_KEY}
) kan in toekomstige API-aanroepen opnieuw worden gebruikt nadat deze zijn gegenereerd. Uw toegangstoken ({ACCESS_TOKEN}
) is tijdelijk en moet om de 24 uur opnieuw worden gegenereerd.
De stappen voor het genereren van deze waarden worden hieronder in detail besproken.
Eenmalige installatie one-time-setup
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 documentatie van de Developer Console.
Als u een project hebt gemaakt, selecteert u API toevoegen op de Overzicht van project scherm.
De Een API toevoegen wordt weergegeven. Selecteren Experience Platform Launch-API uit de lijst met beschikbare API's voordat u Volgende.
Selecteer vervolgens het verificatietype dat u wilt maken voor het genereren van toegangstokens en voor toegang tot de Experience Platform-API.
Selecteren Volgende om door te gaan.
In het volgende scherm wordt u gevraagd een of meer productprofielen te selecteren die u aan de API-integratie wilt koppelen.
Selecteer in de lijst de gewenste productprofielen en selecteer vervolgens geconfigureerde API opslaan om de API-registratie te voltooien.
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.
U hebt twee opties om uw toegangstokens te produceren, afhankelijk van uw gebruiksgeval:
Handmatig toegangstekens genereren manual
Om een nieuwe manueel te produceren {ACCESS_TOKEN}
, navigeer naar Credentials > OAuth Server-to-Server en selecteert u Generate access token, zoals hieronder weergegeven.
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 koptekst voor autorisatie en moet worden opgegeven in de notatie Bearer {ACCESS_TOKEN}
.
Automatisch token genereren auto-token
U kunt ook een Postman-omgeving en -verzameling gebruiken om toegangstokens te genereren. Lees voor meer informatie de sectie over het gebruiken van Postman om API vraag voor authentiek te verklaren en te testen in de Experience Platform API-verificatiegids.
API-referenties testen test-api-credentials
Als u de stappen in deze zelfstudie uitvoert, 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 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 conventies die worden gebruikt in documentatie voor voorbeeld-API-aanroepen raadpleegt u de sectie over voorbeeld-API-aanroepen lezen in de gids Aan de slag voor Platform APIs.
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: