API v6
Construye con la API de Hablame
Autenticación Bearer, envoltura JSON uniforme, cabeceras estándar de límites de uso y un catálogo de errores legible por máquina. Diseñada para integraciones de alto volumen.
Conceptos
Tómalas en orden el primer día; vuelve a ellas como referencia.
Empezar
De cero a tu primera petición autenticada contra la API v6 de Hablame en 30 segundos.
3 min
Autenticación
Esquema Bearer, formato de la API key, ciclo de vida, rotación, buenas prácticas y respuesta a incidentes en la API v6 de Hablame.
6 min
Envoltura de respuesta
La forma uniforme { success, data | error, meta } de la API v6 de Hablame: campos, invariantes y cómo ramificar tu cliente.
5 min
Límites de uso
Modelo de dos capas, headers RateLimit-* según RFC 9598, Retry-After y estrategia de reintentos en la API v6 de Hablame.
5 min
Caché
El contrato X-Cache / X-Cache-TTL de la API v6 de Hablame: cómo distinguir un HIT de un MISS y cuánto sigue siendo válida una respuesta.
4 min
Idempotencia
Cómo usar la cabecera Idempotency-Key en la API v6 de Hablame para reintentar sin duplicar operaciones.
5 min
Webhooks
Los eventos que Hablame envía a tu servidor. Contrato del sobre, firma HMAC y catálogo de eventos por servicio.
El camino más corto al 200
Si `/utilities/ping` devuelve 200, la conexión está bien. De ahí, navega la referencia para los endpoints de cada servicio.
curl -H 'Authorization: Bearer hk_TU_API_KEY' \
https://developers.hablame.co/api/v6/utilities/pingLo documentado hoy
32 endpoints en 9 servicios. Esta lista se genera desde la misma fuente que la referencia, así que no se desactualiza.
Utilidades
Number Insight
Acortador de URLs
/api/v6/urlshortener/linksCrear un enlace cortoGET/api/v6/urlshortener/linksListar enlaces cortosGET/api/v6/urlshortener/domainsListar dominios disponiblesGET/api/v6/urlshortener/links/{domain}/{code}Obtener un enlace cortoPATCH/api/v6/urlshortener/links/{domain}/{code}Actualizar un enlace cortoDELETE/api/v6/urlshortener/links/{domain}/{code}Eliminar un enlace cortoGET/api/v6/urlshortener/links/{domain}/{code}/statsEstadísticas del enlaceText-to-Speech
Call Blasting
/api/v6/callblasting/callsLlamada con voz generadaPOST/api/v6/callblasting/calls/audioLlamada con audio pregrabadoGET/api/v6/callblasting/calls/{id}Estado de una llamadaPOST/api/v6/callblasting/audiosSubir un audio pregrabadoGET/api/v6/callblasting/audiosListar audios pregrabadosGET/api/v6/callblasting/voicesListar voces disponiblesCuenta
Organización
Especificación OpenAPI
La spec se genera desde la misma fuente que esta documentación. Úsala para generar clientes, importar la colección en tu herramienta favorita o validar contratos.