Introducción a Content and Commerce AI

NOTA

La API de contenido y comercio está en fase beta. La documentación está sujeta a cambios.

Content and Commerce AI utiliza las API de Adobe I/O. Para realizar llamadas a las API de Adobe I/O y a la integración de la consola de E/S, primero debe completar el tutorial de autenticación.

Sin embargo, cuando llega al paso Añadir API, la API se encuentra en Experience Cloud en lugar de en Adobe Experience Platform, como se muestra en la siguiente captura de pantalla:

adición de contenido y Commerce AI

Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en todas las llamadas a la API de Adobe I/O, como se muestra a continuación:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Creación de un entorno Postman (opcional)

Una vez configurado el proyecto y la API en Adobe Developer Console, tiene la opción de descargar un archivo de entorno para Postman. En APIs , en el carril izquierdo del proyecto, seleccione Content and Commerce AI. Se abre una nueva pestaña que contiene una tarjeta etiquetada como "Try it out". Seleccione Descargar para Postman para descargar un archivo JSON utilizado para configurar el entorno de postman.

descargar para postman

Una vez descargado el archivo, abra Postman y seleccione el icono de engranaje en la parte superior derecha para abrir el cuadro de diálogo administrar entornos.

icono de engranaje

A continuación, seleccione Import en el cuadro de diálogo Manage environment.

importar

Se le redirige y se le pide que seleccione un archivo de entorno del equipo. Seleccione el archivo JSON que descargó anteriormente y, a continuación, seleccione Abrir para cargar el entorno.

Se le redirige de nuevo a la pestaña Administrar entornos con un nuevo nombre de entorno rellenado. Seleccione el nombre del entorno para ver y editar las variables disponibles en Postman. Aún necesita rellenar manualmente JWT_TOKEN y ACCESS_TOKEN. Estos valores deberían haberse obtenido al completar el tutorial de autenticación.

Una vez completadas, las variables deberían tener un aspecto similar a la captura de pantalla siguiente. Seleccione Update para finalizar la configuración del entorno.

Ahora puede seleccionar su entorno en el menú desplegable de la esquina superior derecha y rellenar automáticamente los valores guardados. Simplemente vuelva a editar los valores en cualquier momento para actualizar todas las llamadas de API.

ejemplo

Para obtener más información sobre cómo trabajar con las API de Adobe I/O mediante Postman, consulte la publicación media sobre el uso de Postman para la autenticación JWT en Adobe I/O.

Leer llamadas de API de ejemplo

Esta guía proporciona ejemplos de llamadas a la API para demostrar cómo dar formato a las solicitudes. Estas incluyen rutas de acceso, encabezados necesarios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en la documentación para las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en la guía de solución de problemas del Experience Platform.

Pasos siguientes

Una vez que tenga todas sus credenciales, estará listo para configurar un trabajador personalizado para Content and Commerce AI. Los siguientes documentos ayudan a comprender el marco de extensibilidad y la configuración del entorno.

Para obtener más información sobre el marco de extensibilidad, comience leyendo el documento introducción a la extensibilidad. Este documento describe los requisitos previos y los requisitos de aprovisionamiento.

Para obtener más información sobre la configuración de un entorno para Content and Commerce AI, comience leyendo la guía para configurar un entorno de desarrollador. Este documento proporciona instrucciones de configuración que le permiten desarrollar para el servicio de Asset compute.

En esta página