Prise en main de REST APIs getting-started-with-rest-apis

Présentation d’Adobe Developer adobeio

Adobe Developer est l’écosystème de développement et la communauté de l’Adobe. Elle comprend API pour tous les produits Adobe.

Il s’agit de la méthode recommandée pour configurer et utiliser Adobe APIs.

Conditions préalables prerequisites

Avant de pouvoir configurer JWT authentification, assurez-vous que vous avez accès au Console Adobe Developer in Adobe Developer. Contactez l’administrateur de votre entreprise pour les demandes d’accès.

Authentification auth

Suivez les étapes ci-dessous pour configurer JWT (Service Account) authentification Adobe Developer:

1. Connectez-vous au Console Adobe Developer.
2. Suivez les étapes décrites dans la section Connexion au compte de service.
   • Durant Étape 2 : Ajout d’une API à votre projet à l’aide de l’authentification du compte de service, choisissez la variable Audience Manager API .
3. Essayez la connexion en effectuant votre première API d’après les instructions de Étape 3.

Autorisations RBAC du compte technique

Si votre compte d’Audience Manager utilise Contrôle d’accès en fonction du rôle, vous devez créer un compte utilisateur technique d’Audience Manager et l’ajouter au groupe RBAC d’Audience Manager qui effectuera les appels d’API.

Pour créer un compte d’utilisateur technique et l’ajouter à un groupe RBAC, procédez comme suit :

1. Effectuez une GET appel à https://aam.adobe.io/v1/users/self. L’appel crée un compte d’utilisateur technique que vous pouvez voir dans la variable Admin Console, dans la variable Users page.

   

2. Connectez-vous à votre compte d’Audience Manager et ajouter le compte utilisateur technique ; au groupe d’utilisateurs qui effectuera les appels d’API.

La variable Audience Manager REST API following OAuth 2.0 normes d’authentification et de renouvellement des jetons. Les sections ci-dessous décrivent comment vous authentifier et commencer à utiliser le APIs.

Création d’une variable générique API Utilisateur requirements

Nous vous recommandons de créer un compte d’utilisateur technique distinct pour utiliser la variable Audience Manager APIs. Il s’agit d’un compte générique qui n’est pas associé à un utilisateur spécifique de votre entreprise ou qui ne lui est pas associé. Ce type de API Le compte utilisateur vous permet d’accomplir 2 tâches :

• Identifiez le service qui appelle le API (par exemple, les appels de vos applications qui utilisent notre APIs ou à partir d’autres outils de API requêtes).
• Fournissez un accès ininterrompu au APIs. Un compte lié à une personne spécifique peut être supprimé lorsqu’elle quitte votre société. Cela vous empêchera de travailler avec les API code. Un compte générique qui n’est pas lié à un employé spécifique vous permet d’éviter ce problème.

Par exemple, pour ce type de compte, supposons que vous souhaitiez modifier de nombreux segments à la fois avec la variable Outils de gestion en bloc. Pour ce faire, votre compte d’utilisateur doit API accès. Au lieu d’ajouter des autorisations à un utilisateur spécifique, créez un API compte utilisateur disposant des informations d’identification, de la clé et du secret appropriés pour créer API appels . Cela s’avère également utile si vous développez vos propres applications qui utilisent la variable Audience Manager APIs.

Travaillez avec votre Audience Manager consultant pour configurer une variable générique, APIcompte utilisateur uniquement.

Processus d’authentification par mot de passe password-authentication-workflow

Authentification par mot de passe sécurisé accédez à REST API. Les étapes ci-dessous décrivent le processus d’authentification par mot de passe à partir d’un JSON dans votre navigateur.

Étape 1 : Requête API Accès

Contactez votre responsable Partenaires en solutions . Ils vous fourniront un API ID client et secret. L’identifiant et le secret vous authentifient dans la variable API.

Remarque : si vous souhaitez recevoir un jeton d’actualisation, indiquez-le lorsque vous demandez API accès.

Étape 2 : demander le jeton

Transmettre une requête de jeton avec vos préférences JSON client. Lorsque vous créez la requête :

• Utilisez une POST méthode d’appel https://api.demdex.com/oauth/token.
• Convertissez votre ID client et votre secret client en chaîne codée en base 64. Séparez l’ID et le secret par deux points au cours du processus de conversion. Par exemple, les informations d’identification testId : testSecret convertir en dGVzdElkOnRlc3RTZWNyZXQ=.
• Transmettre HTTP headers Authorization:Basic <base-64 clientID:clientSecret> et Content-Type: application/x-www-form-urlencoded . Par exemple, votre en-tête peut ressembler à ceci :
  Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
• Configurez le corps de la requête comme suit :
  
  grant_type=password&username=<your-AudienceManager-user-name>&password=<your-AudienceManager-password>

Étape 3 : Réception du jeton

La variable JSON La réponse contient votre jeton d’accès. La réponse doit se présenter comme suit :

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

La variable expires_in key représente le nombre de secondes jusqu’à l’expiration du jeton d’accès. Pour respecter les bonnes pratiques, utilisez de courts délais d’expiration pour limiter l’exposition si le jeton est un jour exposé.

Actualiser le jeton refresh-token

Actualiser le renouvellement des jetons API accéder après l’expiration du jeton d’origine. Si nécessaire, la réponse JSON dans le workflow du mot de passe, inclut un jeton d’actualisation. Si vous ne recevez pas de jeton d’actualisation, créez-en un nouveau par le biais du processus d’authentification par mot de passe.

Vous pouvez également utiliser un jeton d’actualisation pour générer un nouveau jeton avant l’expiration du jeton d’accès existant.

Si votre jeton d’accès a expiré, vous recevez un 401 Status Code et l’en-tête suivant dans la réponse :

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

Les étapes suivantes décrivent le processus d’utilisation d’un jeton d’actualisation pour créer un jeton d’accès à partir d’un JSON dans votre navigateur.

Étape 1 : demander le nouveau jeton

Transmettez une requête de jeton d’actualisation avec vos préférences. JSON client. Lorsque vous créez la requête :

• Utilisez une POST méthode d’appel https://api.demdex.com/oauth/token.
• Convertissez votre ID client et votre secret client en chaîne codée en base 64. Séparez l’ID et le secret par deux points au cours du processus de conversion. Par exemple, les informations d’identification testId : testSecret convertir en dGVzdElkOnRlc3RTZWNyZXQ=.
• Transmission des en-têtes HTTP Authorization:Basic <base-64 clientID:clientSecret> et Content-Type: application/x-www-form-urlencoded. Par exemple, votre en-tête peut ressembler à ceci :
  Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
• Dans le corps de la requête, spécifiez la variable grant_type:refresh_token et transmettez le jeton d’actualisation que vous avez reçu dans votre demande d’accès précédente. La requête doit se présenter comme suit :
  grant_type=refresh_token&refresh_token=b27122c0-b0c7-4b39-a71b-1547a3b3b88e

Étape 2 : réception du nouveau jeton

La variable JSON La réponse contient votre nouveau jeton d’accès. La réponse doit se présenter comme suit :

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

Code d’autorisation et authentification implicite authentication-code-implicit

La variable Audience Manager REST API prend en charge le code d’autorisation et l’authentification implicite. Pour utiliser ces méthodes d’accès, les utilisateurs doivent se connecter à https://api.demdex.com/oauth/authorize pour accéder aux jetons et les actualiser.