Authentification d’API

Avant de pouvoir effectuer des appels à n’importe quel service ou rapport d’API, vous devez utiliser votre nom d’utilisateur et votre mot de passe pour obtenir un jeton d’autorisation auprès du service d’authentification. Le jeton reste actif pendant 2 heures, pendant lesquelles vous n’avez pas besoin de vous authentifier à nouveau. Cette page vous guide tout au long du processus d’authentification.

Étape 1 : Create un fichier au format 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"
    }
}

Étape 2 : POST fichier du service d’authentification

La demande retourne un jeton qui reste valide pendant 2 heures. 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": "Car company c\/o Ad Agency",
                "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.