Cómo probar sin sorpresas
No hay un entorno de pruebas aparte: la API que usas para probar es la misma que usa tu producción. Aquí ves qué puedes llamar sin gastar nada, qué se cobra de verdad y cómo probar con cuidado.
4 min de lecturaRevisado el
No hay un entorno aparte
Todo es real
Con una clave válida, cada petición actúa sobre los datos y el saldo reales de tu organización. No existe un modo de pruebas con datos de mentira ni dinero de prueba: lo que se cobra, se cobra.
La dirección es una sola, https:, tanto para probar como para producción. Lo que sí puedes hacer es separar tus pruebas con una clave propia (con su propio centro de costo, para ver su consumo aparte) y con los permisos mínimos.
Qué puedes llamar sin gastar
Estas consultas no cobran ni cambian nada. Siguen contando para tu límite de uso, como cualquier petición.
GET /: comprueba que tu clave sirve.utilities/ ping - El catálogo de países.
- La consulta de tu organización, si tu clave tiene el permiso
directory. - Todas las consultas del Acortador de URLs: listar y ver enlaces, estadísticas, resumen, dominios y tarifa.
- Todas las consultas de Almacenamiento, con el servicio
storageen tu clave: resumen, consumo, conservación, tarifa, y el listado y detalle de archivos.
Con una excepción menor: pedir un enlace de descarga no cobra, pero deja anotado en el registro de auditoría de tu organización que lo pediste.
Qué se cobra de verdad
| Operación | Qué pasa con el cobro |
|---|---|
| Crear un enlace corto o varios en lote | Cada enlace creado se cobra al precio vigente de tu organización, salvo que tu plan lo incluya. |
| Las visitas a un enlace corto | Después de creado, cada visita de una persona se cobra. Las visitas de robots y las vistas previas que generan las redes sociales y los chats no. |
| Editar, eliminar o restaurar un enlace | No cobran por sí mismas, pero cambian tus datos. Si al restaurar o reactivar un enlace, o al ampliarle o quitarle el vencimiento, este vuelve a redirigir, sus visitas se vuelven a cobrar. |
| Guardar archivos en Almacenamiento | Se cobra por la cantidad guardada y el tiempo (GB al mes), no por consultarla. La tarifa vigente está en su endpoint. |
El precio vigente de cada producto se consulta en su endpoint de tarifa (acortador, almacenamiento); esta documentación no publica cifras para que nunca se desactualicen. Si no hay saldo, la operación se rechaza antes de hacerse (402) y no se cobra nada.
Cómo probar con cuidado
- 01Empieza por el ping
Confirma que la clave, la cabecera y la red funcionan antes de tocar un endpoint que cobra.
- 02No le des el acortador a una clave que no deba crear enlaces
El servicio
urlshortenerse da completo: con él, una clave también crea enlaces, que se cobran. Mientras pruebas otras cosas, usa una clave sin ese servicio, y un error en tu código no podrá gastar saldo por esa vía. - 03Prueba la escritura con pocos datos
Crea un enlace, no cien. Revisa la respuesta completa y ve a
GET /para ver que quedó como esperabas.urlshortener/ links - 04Manda siempre una
Idempotency-Keyal crearSi tu prueba se corta y reintentas, no se crea ni se cobra un segundo enlace. Cómo funciona.
- 05Pon un tope a tus pruebas
Tu organización puede configurar un tope de gasto en Cloud: al alcanzarlo, las operaciones que cobran se rechazan sin hacerse (
URLSHORTENER_SPEND_LIMIT_REACHED). - 06Registra el
requestIdSi algo no sale como esperabas, ese número nos permite encontrar tu petición exacta.
El probador de la referencia envía las peticiones a la API real con tu clave, y cuando una operación cobra, crea o borra, te pide confirmar antes de enviarla. Aun así, es la misma API: léelo como una llamada de producción.
Para el envío de SMS por SMPP, la cuenta la crea el equipo de Hablame: pide acceso y coordina con soporte tus primeras pruebas.
Para dudas técnicas escribe a developers@hablame.co. Si tienes una incidencia en producción, escribe por WhatsApp al +57 319 660 0002, las 24 horas.