Postman en Adobe Experience Platform

Postman es una plataforma de colaboración para el desarrollo de API que le permite configurar entornos con variables preestablecidas, compartir colecciones de API, optimizar solicitudes CRUD y mucho más. La mayoría de los servicios de API de plataforma tienen colecciones Postman que se pueden utilizar para ayudar a realizar llamadas de API.

Configuración de un entorno Postman para Experience Platform

La siguiente guía de vídeo describe la creación y configuración del entorno Postman. Un entorno Postman contiene todos los encabezados necesarios para realizar llamadas de API a las distintas colecciones que se proporcionan a continuación. Una vez configurado, cada vez que un valor caduque (como ACCESS_TOKEN), podrá actualizar el valor actual en el entorno y este nuevo valor se utilizará en todas sus colecciones.

Colecciones Postman

Puede encontrar una carpeta que contenga todas las colecciones Postman disponibles en, visitando el Experience Platform Postman muestra el repositorio de GitHub. Alternativamente, se puede encontrar un vínculo de recopilación de Postman en cada archivo de intercambio individual en la documentación de referencia de la API en el Adobe I/O.

Para descargar una colección de Postman, seleccione Raw en la página de GitHub para cargar el archivo JSON sin procesar en una nueva pestaña. A continuación, haga clic con el botón derecho y seleccione Save as para guardar el archivo en un destino local de su elección.

JSON sin procesar

Importar una colección Postman

Para utilizar una colección Postman, debe tener configurado un entorno. Una vez completada la configuración del entorno, seleccione el selector Manage Environments en la esquina superior derecha.

administrar selector de entorno

Aparece una ventana emergente que muestra todos los entornos actuales. Para importar una colección, seleccione import .

botón importar

Se le pedirá que elija un archivo para importar. Seleccione el archivo de colección Postman que desea importar. Una vez seleccionada, la colección se rellena en el carril izquierdo de la ficha Colecciones.

colección rellenada

Cada colección tiene diferentes pares de clave-valor que pueden ser necesarios para realizar una operación CRUD correcta. Revise la guía para desarrolladores de API del servicio para obtener más información sobre los valores, sugerencias y ver ejemplos necesarios.

Para obtener más información sobre la interfaz de usuario de Postman y sus funciones disponibles, visite la documentación de Postman.

Generar un token de acceso con Postman para uso que no sea de producción

ADVERTENCIA

Como se indica en la colección Postman de generación de token de acceso a Adobe I/O, los métodos de generación indicados son adecuados para usos que no sean de producción. La firma local carga una biblioteca JavaScript desde un host de terceros y la firma remota envía la clave privada a un servicio web que es propiedad de y está gestionado por el Adobe. Aunque Adobe no almacena esta clave privada, las claves de producción nunca deben compartirse con nadie.

El siguiente vídeo utiliza la colección de generación de tokens de acceso al Adobe I/O que se puede descargar del repositorio público de GitHub.

Pasos siguientes

Este documento introdujo entornos Postman, colecciones y cómo importar colecciones. Ahora que tiene Postman listo, visite la Guía de introducción a la plataforma para obtener información sobre los encabezados, ejemplos y una lista de guías de API disponibles para cada servicio de Platform.

En esta página