API v6
Build with the Hablame API
Bearer authentication, a uniform JSON envelope, standard usage-limit headers and a machine-readable error catalog. Designed for high-volume integrations.
Concepts
Take them in order on day one; come back to them as a reference.
Getting started
From zero to your first authenticated request against the Hablame API v6 in 30 seconds.
3 min
Authentication
Bearer scheme, API key format, lifecycle, rotation, best practices and incident response in the Hablame API v6.
6 min
Response envelope
The uniform { success, data | error, meta } shape of the Hablame API v6: fields, invariants and how to branch your client.
5 min
Usage limits
Two-layer model, RFC 9598 RateLimit-* headers, Retry-After and retry strategy in the Hablame API v6.
5 min
Caching
The X-Cache / X-Cache-TTL contract of the Hablame API v6: how to tell a HIT from a MISS and how long a response stays valid.
4 min
Idempotency
How to use the Idempotency-Key header in the Hablame API v6 to retry without duplicating operations.
5 min
Webhooks
The events Hablame sends to your server. Envelope contract, HMAC signature and a per-service event catalog.
The shortest path to a 200
If `/utilities/ping` returns 200, your wiring is fine. From there, browse the reference for the endpoints of each service.
curl -H 'Authorization: Bearer hk_TU_API_KEY' \
https://developers.hablame.co/api/v6/utilities/pingDocumented today
32 endpoints across 9 services. This list is generated from the same source as the reference, so it cannot go stale.
Utilities
Number Insight
URL Shortener
/api/v6/urlshortener/linksCreate a short linkGET/api/v6/urlshortener/linksList short linksGET/api/v6/urlshortener/domainsList available domainsGET/api/v6/urlshortener/links/{domain}/{code}Get a short linkPATCH/api/v6/urlshortener/links/{domain}/{code}Update a short linkDELETE/api/v6/urlshortener/links/{domain}/{code}Delete a short linkGET/api/v6/urlshortener/links/{domain}/{code}/statsLink statisticsText-to-Speech
Call Blasting
/api/v6/callblasting/callsCall with generated voicePOST/api/v6/callblasting/calls/audioCall with pre-recorded audioGET/api/v6/callblasting/calls/{id}Call statusPOST/api/v6/callblasting/audiosUpload a pre-recorded audioGET/api/v6/callblasting/audiosList pre-recorded audiosGET/api/v6/callblasting/voicesList available voicesAccount
Organization
OpenAPI specification
The spec is generated from the same source as this documentation. Use it to generate clients, import the collection into your favorite tool or validate contracts.