Colección de Postman
Cada contrato incluye una colección de Postman preconfigurada con URLs de sandbox y cuerpos de solicitud de ejemplo. Importe la colección, complete sus credenciales y podrá llamar a todos los endpoints sin escribir código.
Colecciones por contrato
| Contrato | Colección | Notas |
|---|---|---|
| Autenticación | Descargar | Descargue el archivo, impórtelo en Postman y reemplace los valores de los parámetros "service_account", "tenant_id" y "secret_key" para probar la solicitud. |
| Web & SDK | Descargar | Incluye creación de proceso, GET process, GET evidences y GET PDF. |
| API | Descargar | Incluye creación de proceso (POST) y GET process. |
Configuración
- Descargue la colección correspondiente al contrato que está integrando.
- Impórtela en Postman:
File > Import > Upload Files. - Configure las credenciales según la colección:
Autenticación — abra la colección, vaya a la pestaña Variables y complete:
| Variable | Valor |
|---|---|
service_account | El nombre de su cuenta de servicio. |
tenant_id | Su ID de tenant. |
secret_key | Su clave privada (formato PEM). |
base_path | Host del endpoint de token. Por defecto apunta a UAT (https://identityhomolog.acesso.io); cámbielo a https://identity.acesso.io para producción. |
Web & SDK — abra cada solicitud y reemplace el valor de Authorization: Bearer por su propio token de acceso.
API — abra cada solicitud y reemplace los valores de los encabezados Authorization: Bearer y APIKEY por sus propias credenciales.
- Ejecute la solicitud de Autenticación — el script de pre-request construye automáticamente el assertion JWT y lo almacena en
{{jwt_token}}.
Scripts de pre-request
Solo la colección de Autenticación incluye un script de pre-request. Este script:
- Lee
service_account,tenant_id,secret_keyybase_pathde las variables de la colección. - Construye y firma el assertion JWT (RS256) usando la biblioteca KJUR embebida.
- Guarda el token firmado en
{{jwt_token}}, que se inyecta automáticamente en el cuerpo de la solicitud.
Las colecciones de Web & SDK y API no tienen scripts de pre-request — las credenciales se configuran directamente en los encabezados de la solicitud.
¿Qué sigue?
- Autenticación — genere las credenciales que necesita la colección.
- Descripción general de Web & SDK — contexto para la colección de Web & SDK.
- Descripción general de API — contexto para la colección de API.