Aesesdocs

Colección de Postman

La colección oficial de Aeses para Postman incluye todos los endpoints de la API pública preorganizados en carpetas, con autenticación, baseUrl y claves de idempotencia ya configurados. Impórtala una sola vez y empieza a llamar a la API sin armar ni una request a mano.

Descargar

Dos archivos: la colección (requests agrupadas por recurso) y un environment con las variables que utiliza.

Descargar colección

Descargar environment

Qué incluye

  • Carpetas por recurso — Deposits, Withdrawals, Balances, Assets, Webhook Deliveries.
  • Autenticación a nivel de colección — toda request hereda x-api-key: {{apiKey}} automáticamente.
  • Variable baseUrl — cambia entre sandbox y producción sin tocar ninguna request.
  • Idempotency-Key precargado con {{$guid}} — Postman genera un UUID nuevo en cada envío, así los reintentos son seguros por defecto.
  • Bodies y query strings de ejemplo — cada POST y endpoint de listado incluye un ejemplo realista listo para editar y ejecutar.

Importar en Postman

  1. Abre Postman y haz clic en Import (arriba a la izquierda).
  2. Arrastra ambos archivos descargados, o usa Files → Upload.
  3. En el selector de environment (arriba a la derecha) elige Aeses — Production.
  4. Haz clic en el ícono del ojo y ajusta apiKey con tu clave secreta (sk_live_… o sk_test_…).
  5. Abre cualquier request — por ejemplo, Balances → List balances — y pulsa Send.
Usa claves de prueba mientras exploras

El environment por defecto se llama Production, pero puede usarse con una clave sk_test_… — Aeses enruta la petición según el prefijo de la clave. Cambia a sk_live_… solo cuando estés listo para mover fondos reales.

Variables

| Variable | Valor por defecto | Dónde configurar | | ----------- | ------------------------ | --------------------------- | | baseUrl | https://api.aeses.io | Environment — modifícalo para apuntar a sandbox si lo necesitas. | | apiKey | sk_live_replace_me | Environment — pega tu clave secreta. Se almacena como variable de tipo secret. | | {{$guid}} | generado automáticamente | Variable dinámica de Postman — usada en Idempotency-Key. Nada que configurar. |

Mantenerla al día

La colección se regenera a partir del mismo descriptor que se usa para validar la API pública. En cada build del sitio de documentación, los archivos servidos en /aeses.postman_collection.json y /aeses.postman_environment.json se actualizan — vuelve a importar para tomar los nuevos endpoints.