API v6
Construye con la API de Hablame
Guías para integrar los servicios de Hablame, qué esperar de cada respuesta y qué hacer cuando algo falla. Empieza por el recorrido de siete pasos: en pocos minutos haces tu primera petición.
Primeros pasos
De cero a tu primera respuesta, y cómo probar sin sorpresas.
Empieza aquí
Recorrido de siete pasos para hacer tu primera petición a la API v6 de Hablame: qué integrar, requisitos, tu clave de API, primera respuesta y soporte.
6 min de lectura
Requisitos
Requisitos para usar la API v6 de Hablame, producto por producto: organización activa, servicio o permiso en la clave de API, saldo o plan y moneda definida.
4 min de lectura
Tu clave de API
Cómo es una clave de API de Hablame, quién puede crearla en Cloud, sus opciones (servicios, capacidades, caducidad y redes permitidas) y cómo eliminarla.
5 min de lectura
Cómo probar sin sorpresas
No hay entorno de pruebas aislado en la API v6 de Hablame. Qué puedes consultar sin costo, qué se cobra de verdad y cómo probar tu integración con cuidado.
4 min de lectura
Guías de producto
Procesos completos, de principio a fin, y no solo peticiones sueltas.
Acortador de URLs
Guía del Acortador de URLs de Hablame: crea enlaces cortos con alias, en lote o con vencimiento, consulta sus visitas y restaura los que eliminas.
9 min de lectura
Almacenamiento
Guía de Almacenamiento de Hablame: consulta lo que guardas, el consumo, la conservación y la tarifa, lista tus archivos y pide enlaces temporales de descarga.
7 min de lectura
SMS
SMS con Hablame: envío por SMPP 3.4 con acuses de entrega y SMS entrantes por webhook. Cómo pedir acceso.
3 min de lectura
Webhooks
Webhooks de Hablame: cómo recibir los SMS entrantes de tu código corto, verificar la firma y responder a tiempo.
4 min de lectura
Conceptos
Lo que comparten todos los endpoints. Léelos una vez y vuelve a ellos cuando los necesites.
Autenticación
Esquema Bearer, formato de la clave de API, ciclo de vida, rotación, buenas prácticas y qué hacer si una clave se expone en la API v6 de Hablame.
7 min de lectura
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 de lectura
Límites de uso y 429 Too Many Requests
Los límites de uso de la API v6 de Hablame: modelo de dos capas, cabeceras RateLimit-*, Retry-After y cómo reintentar sin saturar la API.
6 min de lectura
Caché
Las cabeceras X-Cache y X-Cache-TTL de la API v6 de Hablame: qué significan HIT, MISS y BYPASS y qué esperar hoy de cada endpoint publicado.
3 min de lectura
Idempotencia
Cómo usar la cabecera Idempotency-Key en la API v6 de Hablame para reintentar sin duplicar ni cobrar dos veces, y en qué endpoints se aplica hoy.
5 min de lectura
Ayuda
Cuando algo no sale como esperabas.
Resolución de problemas
Qué significa cada síntoma, su causa más común y cómo resolverlo.
Catálogo de errores
Cada código de error, su causa y cómo resolverlo.
Preguntas frecuentes
Respuestas cortas a lo que más se pregunta.
Glosario
Los términos que usa la documentación, explicados.
Novedades
Qué cambió en la API, con su fecha.
Lo documentado hoy
22 endpoints en 5 grupos. Esta lista sale de la misma fuente que la referencia, así que no se desactualiza.
Utilidades
Acortador de URLs
- POST
/Crear un enlace cortoapi/ v6/ urlshortener/ links - POST
/Crear enlaces cortos en loteapi/ v6/ urlshortener/ links/ batch - GET
/Listar enlaces cortosapi/ v6/ urlshortener/ links - GET
/Listar dominios disponiblesapi/ v6/ urlshortener/ domains - GET
/Obtener un enlace cortoapi/ v6/ urlshortener/ links/ {domain}/ {code} - PATCH
/Actualizar un enlace cortoapi/ v6/ urlshortener/ links/ {domain}/ {code} - DELETE
/Eliminar un enlace cortoapi/ v6/ urlshortener/ links/ {domain}/ {code} - POST
/Restaurar un enlace eliminadoapi/ v6/ urlshortener/ links/ {domain}/ {code}/ restore - GET
/Estadísticas del enlaceapi/ v6/ urlshortener/ links/ {domain}/ {code}/ stats - GET
/Resumen de la organizaciónapi/ v6/ urlshortener/ overview - GET
/Precio vigenteapi/ v6/ urlshortener/ pricing
Almacenamiento
Organización
Para tus herramientas
La especificación de la API para tu editor, tu generador de clientes o tu probador.