API de plateforme numérique - Processus d’authentification

Avant de pouvoir effectuer des appels à l’un des services ou rapports de l’API de plateforme numérique, vous devez utiliser votre nom d’utilisateur et votre mot de passe pour obtenir un jeton d’autorisation. Le jeton reste actif pendant 2 heures, pendant lesquelles vous n’avez pas besoin de vous authentifier à nouveau. En outre, il existe une expiration définitive de 24 heures. Lorsqu’une session d’API atteint la marque de 24 heures, quelle que soit la date d’appel d’API le plus récent, cette session expire.

Cette page vous guide tout au long du processus d’authentification.

Étape 1. Create un fichier JSON, y compris votre nom d’utilisateur et votre mot de passe

Ci-dessous, nous avons utilisé la cat commande pour afficher la sortie du fichier.

$ cat auth
{
    "auth": {
        "username" : "USERNAME",
        "password" : "PASSWORD"
    }
}

Instructions pour la création de votre mot de passe

Lorsque vous créez votre mot de passe, créez un mot de passe complexe avec les éléments suivants :

• 10 caractères ou plus
• 64 caractères ou moins
• Au moins une lettre majuscule (A–Z)
• Au moins une lettre minuscule (a–z)
• Au moins un chiffre (0-9)
• Au moins un caractère spécial (par exemple, #, $, ? %, &)

Étape 2. POST fichier du service d’authentification

La requête retourne un jeton qui reste valide pendant les 2 heures suivant votre appel le plus récent à l’API. Nous vous suggérons d’utiliser «-b cookies -c cookies » dans la POST demande pour stocker le jeton dans un cookie.

$ curl -b cookies -c cookies -X POST -d @auth 'https://api.appnexus.com/auth'
{
    "response": {
        "status": "OK",
        "token": "h20hbtptiv3vlp1rkm3ve1qig0",
        "dbg_info": {
            ...
        }
    }
}

Étape 3. Utiliser le jeton lors des appels aux services et rapports d’API

Dans l’exemple ci-dessous, nous appelons le service membre et nous nous authentifient à l’aide du jeton stocké dans le cookie.

$ curl -b cookies -c cookies 'https://api.appnexus.com/member'
{
    "response": {
        "members": [
            {
                "id": "1",
                "name": "Car company c\/o Ad Agency",
                "active": "1",
                "bidder_id": "2"
            }
        ]
    }
}

Sinon, si vous n’avez pas stocker le jeton dans un cookie, vous pouvez placer le jeton dans l’en-tête de requête en tant que "Authorization: TOKEN".

$ curl -H "Authorization: 622cee5f8c99c81e87614e9efc63eddb" 'https://api.appnexus.com/member'
{
    "response": {
        "members": [
            {
                "id": "1",
                "name": "Member 1",
                "active": "1",
                "bidder_id": "2"
            }
        ]
    }
}

Fréquence d’authentification

Après l’authentification, votre jeton reste valide pendant 2 heures. Vous n’avez pas besoin de vous authentifier à nouveau dans ce délai. Si vous vous authentifiez à nouveau, notez la limitation suivante : L’API vous permet de vous authentifier correctement 10 fois par période de 5 minutes. Toutes les tentatives d’authentification suivantes dans ces 5 minutes entraînent une erreur.

Voir aussi

• Service de récupération de compte
• Bonnes pratiques relatives aux API
• Contraintes d’utilisation de l’API
• Sémantique d’API