Autenticación y acceso a la API de Reactor
Para usar la API de Reactor para crear y administrar extensiones de etiquetas, cada solicitud debe incluir los siguientes encabezados de autenticación:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Esta guía explica cómo utilizar la consola de desarrollador de Adobe para recopilar los valores de cada uno de estos encabezados y así poder empezar a realizar llamadas a la API de Reactor.
Obtener acceso de desarrollador a Adobe Experience Platform gain-developer-access
Para poder generar valores de autenticación para la API de Reactor, debe tener acceso de desarrollador a Experience Platform. Para obtener acceso de desarrollador, siga los pasos iniciales en el tutorial de autenticación de Experience Platform. Una vez que haya completado el paso Obtener acceso de usuario, vuelva a este tutorial para generar las credenciales específicas de la API de Reactor.
Generar credenciales de acceso generate-access-credentials
Con Adobe Developer Console, debe generar las tres credenciales de acceso siguientes:
{ORG_ID}{API_KEY}{ACCESS_TOKEN}
El identificador ({ORG_ID}) y la clave de API ({API_KEY}) de su organización se pueden reutilizar en futuras llamadas de API después de haberlas generado inicialmente. Sin embargo, el token de acceso ({ACCESS_TOKEN}) es temporal y debe regenerarse cada 24 horas.
Los pasos para generar estos valores se tratan en detalle a continuación.
Configuración única one-time-setup
Vaya a la consola de desarrollador de Adobe e inicie sesión con su Adobe ID. A continuación, siga los pasos descritos en el tutorial sobre la creación de un proyecto vacío en la documentación de la consola de desarrollador.
Una vez creado un proyecto, seleccione Agregar API en la pantalla Información general del proyecto.
Aparece la pantalla Añadir una API. Seleccione la API de Experience Platform Launch de la lista de API disponibles antes de seleccionar Siguiente.
A continuación, seleccione el tipo de autenticación para generar tokens de acceso y acceder a la API de Experience Platform.
Haga clic en Siguiente para continuar.
La siguiente pantalla le solicita que seleccione uno o más perfiles de producto para asociarlos a la integración de API.
Seleccione los perfiles de producto que desee en la lista y, a continuación, seleccione Guardar API configurada para completar el registro de la API.
Recopilar credenciales gather-credentials
Una vez agregada la API al proyecto, la página API de Experience Platform del proyecto muestra las siguientes credenciales, que son necesarias en todas las llamadas a las API de Experience Platform:
{API_KEY}(ID de cliente){ORG_ID}(ID de organización)
Generación de un token de acceso generate-access-token
El siguiente paso es generar una credencial {ACCESS_TOKEN} para usarla en llamadas a la API de Platform. A diferencia de los valores de {API_KEY} y {ORG_ID}, se debe generar un nuevo token cada 24 horas para seguir usando las API de Platform.
Tiene dos opciones para generar los tokens de acceso, según el caso de uso:
Generar tokens de acceso manualmente manual
Para generar manualmente un nuevo {ACCESS_TOKEN}, vaya a Credenciales > Servidor a servidor OAuth y seleccione Generar token de acceso, como se muestra a continuación.
Se genera un nuevo token de acceso y se proporciona un botón para copiar el token en el portapapeles. Este valor se usa para el encabezado Autorización requerido y debe proporcionarse con el formato Bearer {ACCESS_TOKEN}.
Automatización de la generación de tokens auto-token
También puede utilizar un entorno y una colección de Postman para generar tokens de acceso. Para obtener más información, lea la sección sobre el uso de Postman para autenticar y probar las llamadas a la API en la guía de autenticación de la API del Experience Platform.
Probar credenciales de API test-api-credentials
Si sigue los pasos de este tutorial, debería tener valores válidos para {ORG_ID}, {API_KEY} y {ACCESS_TOKEN}. Ahora puede probar estos valores usándolos en una simple solicitud cURL a la API de Reactor.
Comience por intentar hacer una llamada API a enumerar todas las empresas.
Una vez que confirme que sus credenciales de acceso funcionan, siga explorando la documentación de referencia de otras API para conocer las muchas capacidades de la API.
Lectura de llamadas de API de muestra read-sample-api-calls
Cada guía de extremo proporciona llamadas de API de ejemplo para demostrar cómo dar formato a sus solicitudes. Estas incluyen rutas, encabezados obligatorios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de la API. Para obtener información sobre las convenciones utilizadas en la documentación de las llamadas de API de ejemplo, consulte la sección sobre cómo leer las llamadas de API de ejemplo en la guía de introducción a las API de Platform.
Pasos siguientes next-steps
Ahora que comprende qué encabezados utilizar, está listo para empezar a realizar llamadas a la API de Reactor. Seleccione una de las guías de extremos para empezar: