GET/api/v6/urlshortener/domains

Listar dominios disponibles

Dominios donde tu organización puede publicar enlaces, con el predeterminado primero.

Alcance y límites

Alcance

API key con el servicio urlshortener habilitado

Límite de uso

30 solicitudes por minuto

Lista los dominios activos donde tu organización puede publicar enlaces: los de la plataforma más los propios ya verificados, con el predeterminado primero y el resto en orden alfabético. Un dominio propio que todavía no está verificado no sirve para crear enlaces y no aparece, salvo que lo pidas con include=unverified (llega con verified: false). No hay un endpoint para registrar o verificar dominios propios.

Parámetros de consulta

include
stringopcional
unverified agrega tus dominios propios que todavía no están verificados, para verlos; no sirven para crear enlaces.
unverified

Respuestas

200

Dominios disponibles.

{
  "success": true,
  "data": {
    "domains": [
      { "name": "h0b.co", "isDefault": true, "verified": true, "global": true, "usedByDefault": true }
    ]
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-09-23T18:30:00+00:00",
    "responseTimeMs": 7.2
  }
}
400

include trae un valor que no existe.

401

Credenciales inválidas o faltantes.

403

La API key no tiene habilitado el acortador (o está apagado para tu organización), la key no se puede usar desde la red de la petición, o la organización no está activa.

429

Se excedió el límite de solicitudes.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

Ver el catálogo completo
GET /api/v6/urlshortener/domains
curl -X GET 'https://developers.hablame.co/api/v6/urlshortener/domains' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer hk_TU_API_KEY'

Try-It

Ejecuta la petición contra la API real con tu propia API key.

La key se usa solo en tu navegador para esta petición. No se guarda ni se envía a ningún otro lado.

Parámetros

unverified agrega tus dominios propios que todavía no están verificados, para verlos; no sirven para crear enlaces.

GET https://developers.hablame.co/api/v6/urlshortener/domains

Respuesta

Todavía no has enviado ninguna petición.