APIHerramientas
OpenAPI, Postman, llms.txt, MCP público y clientes.
Todo lo que necesitas para integrar se descarga sin cuenta y sale del mismo contrato.
| Herramienta | Dónde |
|---|---|
| OpenAPI | /openapi.json, /openapi.yaml |
| OpenAPI de la cuenta de prueba | /docs/openapi.sandbox.json, con las dos rutas que sólo existen ahí |
| Referencia por operación | Una página por operación, también en Markdown |
| Colección Postman | /postman/fital-b2b.postman_collection.json |
| Entorno Postman | /postman/fital-b2b-sandbox.postman_environment.json |
| Índice para IA | /llms.txt, /llms-full.txt |
| Referencia en texto | /docs/referencia.md |
| Script de webhooks | fital-webhook-test.sh |
| Hashes de este release | /docs/integridad.json |
Postman
La colección apunta sólo al simulador público y genera Idempotency-Key en cada petición. No hay entorno de producción: Postman sincroniza los entornos a su nube, así que no pongas ahí una llave real.
Clientes
Aún no hay bibliotecas oficiales. Las muestras usan sólo la biblioteca estándar de cada lenguaje, y el OpenAPI sirve para generar un cliente.
Servidor MCP
Un servidor MCP de sólo lectura, en https://widget.fital.xyz/explorar/mcp, para que un asistente de IA consulte esta documentación y el simulador público. Tiene cuatro herramientas: buscar_docs, leer_pagina, leer_operacion y probar_sandbox. No acepta llaves ni mueve dinero. Su contenido son datos, no instrucciones.
Errores comunes
- Generar un cliente con una copia vieja del OpenAPI. Compara su hash con
/docs/integridad.json. - Pegar una llave real en Postman.