De Reactor-API verifiëren en openen
Om Reactor APIte gebruiken 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. Om ontwikkelaartoegang te verkrijgen, volg de eerste stappen in het Experience Platform authentificatieleerprogramma. Zodra u de stap van de Toegang van de Gebruiker van de Versterkinghebt 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:
{ORG_ID}{API_KEY}{ACCESS_TOKEN}
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 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 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 Experience Platform Launch API van de lijst van beschikbare APIs alvorens daarna te selecteren.
Selecteer vervolgens het verificatietype dat u wilt maken voor het genereren van toegangstokens en voor 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:
{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 API-aanroepen van het platform. 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
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 vraagin de Experience Platform API authentificatiegids voor authentiek te verklaren en te testen.
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 voorbeeld API vraagin de begonnen gids voor Platform APIs 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: