Saltar al contenido principal

Setup de Postman

Postman es la forma más rápida de probar la API sin escribir código. La firma se genera automáticamente con un pre-request script que corre antes de cada request.

1. Variables​

Configurá estas variables en el Environment o en Collection Variables de Postman:

VariableValor
base_urlLa base_url del entorno (ver Entornos).
signature_keyTu signature_key.
signature_secretTu signature_secret.
aviso

Guardá signature_secret como variable de tipo secret en Postman, no en texto plano dentro de la colección compartida.

2. Pre-request script​

Pegá el script de firma en la pestaña Pre-request Script de la colección (así aplica a todas las requests). El script completo y su explicación están en Script de Postman.

El script usa CryptoJS, que Postman incluye de forma nativa (CryptoJS.SHA256, CryptoJS.HmacSHA256). No hace falta instalar nada.

3. Armar una request​

  1. Elegí el método y la URL usando la variable: {{base_url}}/balance/:identifier.
  2. Para requests con body, usá Body → raw → JSON. El script hashea exactamente ese JSON.
  3. Enviá. El script calcula y agrega automáticamente los headers x-signature-key, x-signature-value, x-signature-timestamp y x-idempotency.

4. Verificar la firma​

El script imprime en la consola de Postman (View → Show Postman Console) el canonical string, el hash del body y la firma. Si una request falla con 401, comparar ese canonical con lo que esperás es el primer paso de diagnóstico. Ver Troubleshooting de firma.

Content-Type

Para requests con body JSON, asegurate de que el header Content-Type sea application/json y consistente con el body real: Content-Type es uno de los headers firmados.