Referencia de la API
22 endpoints de la API v6, agrupados por servicio. Cada uno explica qué hace, quién puede llamarlo, sus límites y sus errores, y lo puedes probar desde su página.
URL base
https:
Autenticación
Cada petición lleva tu API key en la cabecera Authorization:. Sin ella, la API responde 401.
Antes de empezar
Endpoints por servicio
Utilidades (1 endpoints)
Endpoints de diagnóstico, disponibles para cualquier API key. Sirven para verificar que tus credenciales quedaron bien conectadas.
Herramientas (2 endpoints)
Catálogos de propósito general que puedes consumir desde tu aplicación. Disponibles para cualquier API key.
Acortador de URLs (11 endpoints)
Crea y administra enlaces cortos en tus dominios y consulta su analítica de clics.
- POST
/Crear un enlace cortoPublica un enlace corto con código generado o alias propio. Se cobra al crearlo, salvo que tu plan lo incluya.api/ v6/ urlshortener/ links - POST
/Crear enlaces cortos en loteHasta 1.000 enlaces en una petición, con un resultado por enlace y un solo cobro por lo que se creó.api/ v6/ urlshortener/ links/ batch - GET
/Listar enlaces cortosTus enlaces paginados, con búsqueda, filtros, orden y sus contadores de visitas.api/ v6/ urlshortener/ links - GET
/Listar dominios disponiblesDominios donde tu organización puede publicar enlaces, con el predeterminado primero.api/ v6/ urlshortener/ domains - GET
/Obtener un enlace cortoUn enlace tuyo por dominio y código.api/ v6/ urlshortener/ links/ {domain}/ {code} - PATCH
/Actualizar un enlace cortoCambia el destino, el estado o el vencimiento. El dominio y el código no cambian.api/ v6/ urlshortener/ links/ {domain}/ {code} - DELETE
/Eliminar un enlace cortoEl enlace deja de redirigir y desaparece de la API. Su código queda ocupado, y lo puedes restaurar durante 90 días.api/ v6/ urlshortener/ links/ {domain}/ {code} - POST
/Restaurar un enlace eliminadoDevuelve a la vida un enlace tuyo que eliminaste, con el mismo código y sin nuevo cobro.api/ v6/ urlshortener/ links/ {domain}/ {code}/ restore - GET
/Estadísticas del enlaceTotales del rango, serie por día o por hora y desgloses por país, dispositivo, sistema, navegador u origen.api/ v6/ urlshortener/ links/ {domain}/ {code}/ stats - GET
/Resumen de la organizaciónInventario, actividad del rango frente al periodo anterior, evolución, más visitados y desgloses de toda tu organización.api/ v6/ urlshortener/ overview - GET
/Precio vigenteCuánto le cuesta a tu organización crear un enlace y cada visita, y si su plan lo incluye.api/ v6/ urlshortener/ pricing
Almacenamiento (7 endpoints)
Consulta lo que guarda tu organización: uso, consumo, archivos, enlaces de descarga, conservación y tarifa. Solo lectura; el almacenamiento nunca se pausa.
- GET
/ResumenLo que tu organización tiene guardado ahora, lo que lleva el mes y lo que se elimina pronto.api/ v6/ storage/ summary - GET
/ConsumoSerie del almacenamiento usado (GB al mes y costo) por día, por mes o por hora.api/ v6/ storage/ usage - GET
/Listar archivosLos archivos de tu organización, del más reciente al más antiguo, paginados por cursor.api/ v6/ storage/ objects - GET
/Consultar un archivoEl detalle de un archivo de tu organización.api/ v6/ storage/ objects/ {id} - GET
/Enlace de descargaUn enlace temporal para descargar un archivo.api/ v6/ storage/ objects/ {id}/ download-url - GET
/ConservaciónCuánto tiempo se guarda cada tipo de archivo antes de eliminarse.api/ v6/ storage/ retention - GET
/Tarifa vigenteEl precio por GB al mes que se le aplica hoy a tu organización, y el próximo si ya está fijado.api/ v6/ storage/ pricing
Organización (1 endpoints)
Perfil de la organización, centros de costo y usuarios. Incluye datos personales.