Autentisera och få åtkomst till Reactor API
Om du vill använda Reaktors-API för att skapa och hantera taggtillägg måste varje begäran innehålla följande autentiseringsrubriker:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Den här guiden beskriver hur du använder Adobe Developer Console för att samla in värdena för vart och ett av dessa rubriker så att du kan börja anropa Reactor API.
Få utvecklare tillgång till Adobe Experience Platform gain-developer-access
Innan du kan generera autentiseringsvärden för Reactor API måste du ha utvecklaråtkomst till Experience Platform. Om du vill få utvecklaråtkomst följer du de inledande stegen i självstudiekursen Experience Platform. När du har slutfört steget Få tillgång till användare går du tillbaka till den här självstudiekursen för att generera de specifika autentiseringsuppgifterna för Reactor API.
Generera autentiseringsuppgifter generate-access-credentials
Med Adobe Developer Console måste du generera följande tre autentiseringsuppgifter:
{ORG_ID}{API_KEY}{ACCESS_TOKEN}
Organisationens ID ({ORG_ID}) och API-nyckel ({API_KEY}) kan återanvändas i framtida API-anrop efter att de först har genererats. Åtkomsttoken ({ACCESS_TOKEN}) är tillfällig och måste genereras om var 24:e timme.
Stegen för att generera dessa värden beskrivs närmare nedan.
Engångskonfiguration one-time-setup
Gå till Adobe Developer Console och logga in med din Adobe ID. Följ sedan stegen som beskrivs i självstudiekursen om att skapa ett tomt projekt i Developer Console-dokumentationen.
När du har skapat ett projekt väljer du Lägg till API på skärmen Projektöversikt.
Skärmen Lägg till ett API visas. Välj Experience Platform Launch API i listan över tillgängliga API:er innan du väljer Nästa.
Välj sedan autentiseringstypen för att generera åtkomsttoken och få åtkomst till Experience Platform-API:t.
Välj Nästa för att fortsätta.
På nästa skärm får du en uppmaning om att välja en eller flera produktprofiler som ska associeras med API-integreringen.
Välj önskade produktprofiler i listan och välj sedan Spara konfigurerad API för att slutföra API-registreringen.
Samla in inloggningsuppgifter gather-credentials
När API:t har lagts till i projektet visar Experience Platform API-sidan för projektet följande autentiseringsuppgifter som krävs i alla anrop till API:er för Experience Platform:
{API_KEY}(Client ID){ORG_ID}(Organization ID)
Generera en åtkomsttoken generate-access-token
Nästa steg är att generera en {ACCESS_TOKEN}-autentiseringsuppgift som kan användas i API-anrop för plattformar. Till skillnad från värdena för {API_KEY} och {ORG_ID} måste en ny token genereras var 24:e timme för att du ska kunna fortsätta använda plattforms-API:er.
Det finns två alternativ för att generera åtkomsttoken, beroende på hur du använder dem:
Generera åtkomsttoken manuellt manual
Om du vill generera en ny {ACCESS_TOKEN} manuellt går du till Credentials > OAuth Server-to-Server och väljer Generate access token enligt nedan.
En ny åtkomsttoken genereras och en knapp för att kopiera token till Urklipp tillhandahålls. Det här värdet används för det obligatoriska auktoriseringshuvudet och måste anges i formatet Bearer {ACCESS_TOKEN}.
Automatisera generering av token auto-token
Du kan också använda en Postman-miljö och en samling för att generera åtkomsttoken. Mer information finns i avsnittet om att använda Postman för att autentisera och testa API-anrop i autentiseringsguiden för Experience Platform API.
Testa API-autentiseringsuppgifter test-api-credentials
Om du följer stegen i den här självstudiekursen bör du ha giltiga värden för {ORG_ID}, {API_KEY} och {ACCESS_TOKEN}. Du kan nu testa dessa värden genom att använda dem i en enkel cURL-begäran till Reactor API.
Börja med att försöka göra ett API-anrop till listan över alla företag.
När du har bekräftat att dina inloggningsuppgifter fungerar kan du fortsätta att utforska den andra API-referensdokumentationen och lära dig API:ts många funktioner.
Läser exempel-API-anrop read-sample-api-calls
Varje slutpunktshandbok innehåller exempel på API-anrop som visar hur du formaterar dina begäranden. Det kan vara sökvägar, obligatoriska rubriker och korrekt formaterade begärandenyttolaster. Ett exempel på JSON som returneras i API-svar finns också. Information om de konventioner som används i dokumentationen för exempel-API-anrop finns i avsnittet Så här läser du exempel-API-anrop i Komma igång-guiden för Platform API:er.
Nästa steg next-steps
Nu när du förstår vilka rubriker du ska använda kan du börja ringa anrop till Reaktors API. Välj någon av slutpunktsguiderna för att komma igång: