Aan de slag met REST APIs getting-started-with-rest-apis

Adobe Developer - Overzicht adobeio

Adobe Developer is het ecosysteem en de gemeenschap van ontwikkelaars van Adobe. Hieronder vallen API's voor alle Adobe producten.

Dit is de aanbevolen manier om Adobe APIs.

Vereisten prerequisites

Voordat u kunt configureren JWT verificatie, zorg ervoor dat u toegang hebt tot de Adobe Developer Console in Adobe Developer. Neem contact op met uw organisatiebeheerder voor verzoeken om toegang.

Verificatie auth

Voer de onderstaande stappen uit om te configureren JWT (Service Account) verificatie met Adobe Developer:

1. Aanmelden bij de Adobe Developer Console.
2. Voer de stappen uit in Verbinding serviceaccount.
   • Tijdens Stap 2: voeg API aan uw project toe gebruikend de authentificatie van de Rekening van de Dienst, kiest u de Audience Manager API -optie.
3. Probeer de verbinding uit door eerst uw API vraag gebaseerd op de instructies van Stap 3.

Machtigingen voor RBAC's van technische rekeningen

Als uw Audience Manager-account Op rollen gebaseerd Toegangsbeheer, moet u een technische gebruikersrekening van de Audience Manager tot stand brengen en het toevoegen aan de Audience Manager RBAC groep die de API vraag zal maken.

Voer de onderstaande stappen uit om een technische gebruikersaccount te maken en deze toe te voegen aan een RBAC-groep:

1. Maak een GET oproep aan https://aam.adobe.io/v1/users/self. De vraag zal tot een technische gebruikersrekening leiden die u in kunt zien Admin Consolein de Users pagina.

   

2. Meld u aan bij uw Audience Manager-account en toevoegen aan de technische gebruikersaccount aan de gebruikersgroep die de API vraag zal maken.

De Audience Manager REST API volgt OAuth 2.0 normen voor tokenauthentificatie en vernieuwing. In de onderstaande secties wordt beschreven hoe u de verificatie uitvoert en met de functie APIs.

Een generiek bestand maken API Gebruiker requirements

We raden u aan een aparte, technische gebruikersaccount te maken voor het werken met de Audience Manager APIs. Dit is een generieke account die niet is gekoppeld aan of gekoppeld aan een specifieke gebruiker in uw organisatie. Dit type van API Met gebruikersaccount kunt u twee dingen doen:

• Identificeer welke dienst roept API (Bijvoorbeeld, vraag van uw apps die onze gebruiken APIs of van andere gereedschappen die API verzoeken).
• Ononderbroken toegang tot de APIs. Een account die aan een bepaalde persoon is gekoppeld, kan worden verwijderd wanneer deze uw bedrijf verlaat. Zo voorkomt u dat u met de beschikbare API code. Met een algemene account die niet aan een bepaalde werknemer is gekoppeld, voorkomt u dit probleem.

Als voorbeeld of gebruiksgeval voor dit type van rekening, laten wij zeggen u veel segmenten in één keer met wilt veranderen Bulkbeheertools. Wel, om dit te doen, heeft uw gebruikersrekening nodig API toegang. In plaats van machtigingen toe te voegen aan een specifieke gebruiker, maakt u een niet-specifieke gebruiker. API gebruikersaccount met de juiste gegevens, sleutel en geheim om API oproepen. Dit is ook handig als u uw eigen toepassingen ontwikkelt die gebruikmaken van de Audience Manager APIs.

Werk met uw Audience Manager consultant voor het opzetten van een generiek API-only user account.

Workflow voor wachtwoordverificatie password-authentication-workflow

Wachtwoordverificatie veilige toegang tot onze REST API. De onderstaande stappen geven een overzicht van de workflow voor wachtwoordverificatie via een JSON in uw browser.

Stap 1: Verzoek API Toegang

Contacteer uw manager van de Oplossingen van de Partner. Zij zullen u van een API client-id en geheim. De id en het geheim verifiëren u aan API.

Opmerking: als u een vernieuwingstoken wilt ontvangen, geeft u dat op wanneer u een aanvraag indient API toegang.

Stap 2: De token aanvragen

Geef een symbolische aanvraag door aan uw voorkeur JSON client. Wanneer u het verzoek bouwt:

• Een POST methode om aan te roepen https://api.demdex.com/oauth/token.
• Zet uw cliënt ID en geheim in een basis-64 gecodeerde koord om. Scheid de id en het geheim tijdens het conversieproces met een dubbele punt. Bijvoorbeeld de referenties testId : testSecret omzetten in dGVzdElkOnRlc3RTZWNyZXQ=.
• Geef in HTTP headers Authorization:Basic <base-64 clientID:clientSecret> en Content-Type: application/x-www-form-urlencoded . De koptekst kan er bijvoorbeeld als volgt uitzien:
  Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
• Stel de aanvraaginstantie als volgt in:
  
  grant_type=password&username=<your-AudienceManager-user-name>&password=<your-AudienceManager-password>

Stap 3: Ontvang het token

De JSON reactie bevat uw toegangstoken. De reactie moet er als volgt uitzien:

{
    "access_token": "28fed402-eafd-456c-9341-ac753f25bbbc",
    "token_type": "bearer",
    "refresh_token": "b27122c0-b0c7-4b39-a71b-1547a3b3b88e",
    "expires_in": 21922,
    "scope": "read write"
}

De expires_in key vertegenwoordigt het aantal seconden tot het toegangstoken verloopt. U kunt het beste korte vervaltijden gebruiken om de belichting te beperken als het token ooit wordt blootgesteld.

Token vernieuwen refresh-token

Tokens vernieuwen API toegang nadat het originele teken verloopt. Indien gevraagd, het antwoord JSON in de wachtwoordworkflow bevat een token voor vernieuwen. Als u ontvangt vernieuw symbolisch, creeer nieuwe door het proces van de wachtwoordauthentificatie.

U kunt ook een vernieuwingstoken gebruiken om een nieuw token te genereren voordat het bestaande toegangstoken verloopt.

Als uw toegangstoken is verlopen, ontvangt u een 401 Status Code en de volgende koptekst in het antwoord:

WWW-Authenticate: Bearer realm="oauth", error="invalid_token", error_description="Access token expired: <token>"

In de volgende stappen wordt een overzicht gegeven van de workflow voor het gebruik van een vernieuwingstoken om een nieuw toegangstoken te maken van een JSON in uw browser.

Stap 1: Nieuwe token aanvragen

Geef een vernieuwingstoken-aanvraag door aan uw voorkeur JSON client. Wanneer u het verzoek bouwt:

• Een POST methode om aan te roepen https://api.demdex.com/oauth/token.
• Zet uw cliënt ID en geheim in een basis-64 gecodeerde koord om. Scheid de id en het geheim tijdens het conversieproces met een dubbele punt. Bijvoorbeeld de referenties testId : testSecret omzetten in dGVzdElkOnRlc3RTZWNyZXQ=.
• Geef in de HTTP-headers door Authorization:Basic <base-64 clientID:clientSecret> en Content-Type: application/x-www-form-urlencoded. De koptekst kan er bijvoorbeeld als volgt uitzien:
  Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
• Vermeld in de aanvraaginstantie de grant_type:refresh_token en ga binnen vernieuwen teken u in uw vorig toegangsverzoek ontving. Het verzoek moet er als volgt uitzien:
  grant_type=refresh_token&refresh_token=b27122c0-b0c7-4b39-a71b-1547a3b3b88e

Stap 2: Ontvang het Nieuwe Token

De JSON de reactie bevat uw nieuw toegangstoken. De reactie moet er als volgt uitzien:

{
    "access_token": "4fdfc261-2ffc-4fb7-8dbd-64221714c45f",
    "token_type": "bearer",
    "refresh_token": "295fa487-1825-4caa-a715-80b81ac17dae",
    "expires_in": 21922,
    "scope": "read write"
}

Autorisatiecode en impliciete verificatie authentication-code-implicit

De Audience Manager REST API steunt vergunningscode en impliciete authentificatie. Om deze toegangsmethodes te gebruiken, moeten uw gebruikers login aan https://api.demdex.com/oauth/authorize om tokens te openen en te vernieuwen.