Partekatu honen bidez:

API de Yield Analytics: proceso de autenticación

Esta página le guiará por el proceso de autenticación:

  • La autenticación es necesaria antes de acceder a los servicios de API. Las API de FMI exponen los datos de la aplicación de forma segura y solo están disponibles para los usuarios autenticados a través de protocolos de transporte seguros.
  • Antes de llamar a cualquier punto de conexión de la API de IMF, debe autenticarse mediante el nombre de usuario y la contraseña de la plataforma a través del servicio de autenticación en: https://api.appnexus.com/auth.
  • Una solicitud de autenticación correcta devuelve un token de autorización que es válido durante dos horas. A continuación, este token se puede usar para realizar solicitudes a todos los puntos de conexión en: https://api.appnexus.com/imf.
  • No es necesario volver a realizar la autenticación mientras el token sigue siendo válido.
  • Para mayor comodidad, se recomienda almacenar el token de autorización en una cookie mediante las opciones de la -b cookies -c cookies solicitud de autenticación. Esto garantiza que el token se incluya automáticamente en todas las llamadas API posteriores.

Nota:

El nombre de usuario y la contraseña de autenticación son las mismas credenciales que se usan para Digital Platform API o Microsoft Monetize.

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. Creación de 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"
    }
}

Directrices para crear la contraseña

Al crear la contraseña, cree una contraseña compleja con lo siguiente:

  • 10 o más caracteres
  • 64 caracteres o menos
  • Al menos una letra mayúscula (A–Z)
  • Al menos una letra minúscula (a–z)
  • Al menos un dígito (0–9)
  • Al menos un carácter especial (como #, $, ? %, &)

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 solicitud POST 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": "h3vlp0122344",
        "dbg_info": {
            ...
        }
    }
}

Paso 3. Uso del token al realizar llamadas a servicios de LA API de IMF

A continuación, el token emitido se puede usar para acceder a todos los puntos de conexión disponibles en el punto de conexión api.appnexus.com/imfde host .

$ curl -b cookies -c cookies 'https://api.appnexus.com/imf/api/v1/rest/data/aliasFunctions'
{
    "response": {
        "aliasFunctions": [
            {
                "name": "ACTIVE_CUSTOM_PRODUCTS",
                "inputs": [
                "ARRAY"
                ]
            },
        ...
        ]
    }
}

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: h3vlp0122344" 'https://api.appnexus.com/imf/api/v1/rest/data/aliasFunctions' 
{
    "response": {
        "aliasFunctions": [
            {
                "name": "ACTIVE_CUSTOM_PRODUCTS",
                "inputs": [
                "ARRAY"
                ]
            },
        ...
        ]
    }
}

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. Si vuelve a autenticarse, tenga en cuenta la siguiente limitación:

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

Sugerencia

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

  • Last updated on