OpenAPI
La especificación OpenAPI 3.1 de la API v6 de Hablame. Sirve para generar un cliente en tu lenguaje, importar la API en tu herramienta de pruebas o revisar todo el contrato en un solo archivo.
Descarga
Los archivos en español y en inglés describen exactamente lo mismo; solo cambian las descripciones.
Qué trae
- Los 22 endpoints publicados de la Referencia, con sus parámetros, cuerpos, ejemplos de respuesta y errores posibles.
- Un solo servidor:
https:. Todo lo que ejecutes contra él es real y puede cobrarse./ / developers. hablame. co - La autenticación con tu clave de API como token Bearer. La clave nunca va dentro del archivo.
- Qué hace cada operación al ejecutarla, en la extensión
x-hablame-efecto(ninguno,consulta-facturable,crea,modifica,borra,envia,llama), y si la llamada se cobra, enx-hablame-cobra. - El límite de uso y la clave que pide cada operación, en
x-limityx-access. - Los avisos (webhooks) que Hablame envía a tu servidor, empezando por el SMS entrante (
sms.).mo
Cómo usarlo
- Descárgalo con el botón de arriba o desde la terminal:
curl -O https:./ / developers. hablame. co/ openapi. es. json - Impórtalo como archivo en la herramienta de pruebas de API o en el visor de OpenAPI que uses.
- Para generar un cliente, pásaselo al generador de tu lenguaje (por ejemplo openapi-generator, oapi-codegen o NSwag) y revisa el código generado antes de llevarlo a producción.
Siempre al día
Este archivo se genera con el mismo catálogo que la Referencia cada vez que se publica el sitio. Si un endpoint cambia, el archivo cambia con él: no hay una copia aparte que pueda quedar desactualizada.
Ver las novedades de la API · Si prefieres Postman, ve a la colección
Si algo del archivo no coincide con lo que ves al ejecutar una llamada, escríbenos a developers@hablame.co con el endpoint y el identificador de la solicitud (requestId).