Referencia de la API
La versión actual es API v2. URL base:
https://api.revolink.link/apiv2
Sigue una especificación OpenAPI 3.1: https://api.revolink.link/apiv2/openapi.json. Documentación interactiva, donde puedes consultar cada campo: https://api.revolink.link/apiv2/docs.
Inicio rápido
bash
curl -X POST https://api.revolink.link/apiv2/links \
-H "Authorization: Bearer rvlnk_your_api_key_here" \
-H "X-Workspace-Id: your_workspace_id" \
-H "Content-Type: application/json" \
-d '{ "url": "https://example.com" }'
O con el SDK de TypeScript:
ts
import {Revolink} from 'revolink';
const revolink = new Revolink({apiKey: process.env.REVOLINK_API_KEY!, workspaceId: process.env.REVOLINK_WORKSPACE_ID!});
const {shortLink} = await revolink.links.create({url: 'https://example.com'});
Qué incluye la API v2
| Autenticación | Clave de API, cabecera del espacio de trabajo, permisos, límite de peticiones |
| Enlaces | Listar, crear, upsert, actualizar, eliminar y operaciones masivas |
| Analítica | Analítica de clics de un enlace o de un espacio de trabajo |
| Etiquetas y dominios | Gestión de etiquetas y dominios propios |
| Errores y respuestas | Formato de respuesta, códigos de error, paginación |
| SDK de TypeScript | npm install revolink |
API v1
Los endpoints de gestión con clave de API de la API v1 (/apiv1/link/create y otros cinco) fueron sustituidos por la API v2 y ahora responden 410 Gone. Consulta la API v1 para ver la lista y a dónde se movió cada uno. Los endpoints públicos de v1 y el servidor MCP no se ven afectados.