Saltar al contenido principal

Colección de Postman

Hay una colección y un environment de Postman generados desde el OpenAPI de la API, para que no se desactualicen:

Impórtalos en Postman y ajusta las variables del environment:

VariableValor
baseUrlDirección del API (local: http://localhost:18083)
keycloakUrlSolo si pides el token directo a Keycloak (local: http://localhost:18081); con POST /api/auth/token no se usa
merchantId / merchantSecretTus credenciales
tokenLo llena la petición Obtener token (guarda access_token)

Además hay una colección en forma de flujo para integrar una app de pago con un comercio (token, links, webhook del comercio, transferencia entre cuentas Crezcamos y confirmación): mosi-gran-kiosko.postman_collection.json. Pide el token con POST /api/auth/token; no usa Keycloak. Esta no se regenera: se mantiene a mano.

Regenerar​

Tras actualizar el snapshot del OpenAPI (scripts/sync-openapi.sh):

cd developers
npm run postman

Esto reescribe los dos archivos de static/postman/.

nota

La colección cubre los endpoints del spec. Los webhooks entrantes y la firma de webhooks salientes se prueban con los curl y los vectores de esas páginas.