Saltar al contenido
Menú de Hablame Developers
Crea tu clave de APISe abre en una pestaña nueva

Novedades de la API

Qué cambió en la API, con su fecha. Solo se anota lo que tiene una fuente verificable.

Cómo leer esta página

Cada novedad lleva su fecha real. Un cambio que puede afectar a tu integración se marca como «Cambio»; lo demás es algo nuevo o un ajuste de esta documentación.

  1. Cambio

    La validación de números exige su servicio en la clave

    Consultar números ya no funciona con cualquier clave válida: la clave necesita el servicio Validación de números.

    • Las rutas /api/v6/numberinsight/* exigen el servicio numberinsight, que en Cloud aparece como «Validación de números». Sin él, responden 403 AUTH_SERVICE_NOT_ALLOWED.
    • Si tu integración consulta números, pídele al propietario de tu organización una clave con ese servicio. El cobro de las consultas no cambia.

  2. Cambio

    Cada servicio de una clave se da completo, y solo el propietario crea claves

    El permiso de una clave sobre un servicio es total o no existe. Las capacidades quedan solo para la cuenta.

    • Se retiran las capacidades urlshortener.write y storage.files. Solo quedan account y directory, que son de la cuenta.
    • El servicio urlshortener da todo el acortador: listar y consultar, y también crear (cada alta se cobra), editar, eliminar y restaurar enlaces. El servicio storage da las siete consultas de Almacenamiento, archivos y descargas incluidos; sin él, las siete responden 403 AUTH_SERVICE_NOT_ALLOWED.
    • Solo el propietario de la organización crea claves de API. Quién puede eliminarlas no cambia: quien la creó, el propietario o un administrador.

  3. Documentación

    La referencia muestra solo lo que funciona

    La referencia pública pasa a documentar los 22 endpoints que hoy responden, y los demás dejan de aparecer.

    • Quedan publicados el Acortador de URLs (11 endpoints), Almacenamiento (7, todos de consulta), la consulta de tu organización, el catálogo de países (2) y el ping.
    • Dejan de aparecer en la referencia, en OpenAPI y en Postman los endpoints de servicios que todavía no están abiertos y los que responden 501 NOT_IMPLEMENTED.
    • La página de webhooks de Validación de números se retira y redirige a los eventos de webhooks.

  4. Nuevo

    Almacenamiento se puede consultar por la API

    Siete consultas nuevas para ver lo que guardas, su consumo, su conservación y su tarifa, y para listar y descargar tus archivos.

  5. Nuevo

    Acortador de URLs: lote, reintentos seguros y restauración

    Un conjunto de cambios del Acortador de URLs, aprobados tras su auditoría del 30 de septiembre.

    • Nuevo: crear hasta 1.000 enlaces en una petición, con un resultado por enlace.
    • Vuelve la cabecera Idempotency-Key al alta de un enlace y al lote: un reintento no crea ni cobra dos veces. Ver Idempotencia.
    • El listado pagina por cursor sin tope, y su total es exacto hasta 10.000.
    • Nuevo: restaurar un enlace eliminado durante 90 días, sin nuevo cobro.
    • Nuevo estado blocked para los enlaces que Hablame bloquea por seguridad, y nuevo campo domainStatus que dice si el dominio deja abrir el enlace.
    • Con un plan mensual del acortador hay un cupo diario de altas (URLSHORTENER_LINK_QUOTA_EXCEEDED).
    • Se rechazan más destinos peligrosos, y en los dominios compartidos los alias que imitan una marca, un banco o una entidad pública. Los dominios propios sin verificar ya no se ofrecen para crear enlaces.

  6. Cambio

    Escribir en el acortador pide una capacidad aparte

    Crear, editar, eliminar y restaurar enlaces exige la capacidad urlshortener.write; consultar sigue pidiendo solo el servicio.

    • Hasta esa fecha, cualquier clave con el servicio urlshortener podía crear, redirigir y eliminar todos los enlaces de la organización. Ahora la escritura exige urlshortener.write, que solo concede un propietario o un administrador al crear la clave.
    • Las claves del acortador emitidas antes de ese cambio recibieron la capacidad, así que siguen escribiendo como antes. Una clave sin ella responde 403 AUTH_CAPABILITY_NOT_ALLOWED al escribir.

  7. Nuevo

    Claves de API con redes permitidas

    Una clave puede crearse para funcionar solo desde ciertas IP o rangos de IP.

    • Al crear una clave en Cloud puedes indicar hasta 20 IP o rangos. Desde cualquier otra red, la API responde 403 AUTH_IP_NOT_ALLOWED.
    • La IP con la que la API vio tu petición viene en meta.clientIp de cada respuesta. La lista no se puede cambiar después de crear la clave.

¿Necesitas ayuda?

¿Te sirvió esta página?

Ver todos los canales de soporte