Compartir a través de

Autenticación de API

  • Artículo

Para poder realizar llamadas a cualquier informe o servicio de API, debe usar el nombre de usuario y la contraseña para obtener un token de autorización del servicio de autenticación. El token permanece activo durante 2 horas, durante las cuales no es necesario volver a autenticarse. Esta página le guiará por el proceso de autenticación.

Sugerencia

Si ha olvidado su nombre de usuario o contraseña, puede usar account recovery service para recuperar el nombre de usuario o crear una nueva contraseña.

Paso 1: Create un archivo con formato JSON, incluidos el nombre de usuario y la contraseña

A continuación, hemos usado el cat comando para mostrar la salida del archivo.

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

Paso 2: POST el archivo al servicio de autenticación

La solicitud devuelve un token que permanece válido durante 2 horas. Se recomienda usar "-b cookies -c cookies" en la POST solicitud para almacenar el token en una cookie.

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

Paso 3: Uso del token al realizar llamadas a informes y servicios de API

En el ejemplo siguiente, llamamos al servicio miembro y nos autenticamos mediante el token almacenado en la 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"
            }
        ]
    }
}

Como alternativa, si no ha almacenado el token en una cookie, puede colocar el token en el encabezado de solicitud como "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"
            }
        ]
    }
}

Frecuencia de autenticación

Después de autenticarse, el token permanece válido durante 2 horas. No es necesario volver a autenticarse en este momento.

Nota:

Si vuelve a autenticarse, tenga en cuenta la siguiente limitación:

  1. La API le permite autenticarse correctamente 10 veces por período de 5 minutos.
  2. Los intentos de autenticación posteriores en esos 5 minutos producirán un error.

Sugerencia

Se recomienda escuchar "NOAUTH" error_id en las respuestas de llamada y volver a autenticarse solo después de recibirlo.