Return to top
En esta página

Autenticación (API v1, eliminada)

Los endpoints con clave de la API v1 ya no funcionan

Responden 410 Gone. Usa la API v2: la clave va en Authorization: Bearer <key> y el espacio de trabajo en la cabecera X-Workspace-Id. Esta página se conserva solo para ayudarte a migrar. Consulta a dónde se movió cada endpoint.

Todos los endpoints de gestión de la API v1 requerían autenticación con clave de API. Cada petición debe incluir dos cosas: una clave de API en la cabecera y un Workspace ID en el cuerpo de la petición o en la cadena de consulta.

URL base 

https://api.revolink.link/apiv1/

Cómo obtener tus credenciales

  1. Abre la aplicación de Revolink y ve a Perfil → Integraciones.
  2. Haz clic en Generar clave de API. Copia y guarda la clave: se muestra una sola vez. Si la pierdes, genera una nueva (la anterior queda invalidada de inmediato).
  3. Copia tu Workspace ID de la misma página.

Enviar la clave de API

Pasa la clave en la cabecera X-Api-Key en cada petición:

X-Api-Key: rvlnk_your_api_key_here

Enviar el Workspace ID

Incluye workspaceId en cada petición:

  • POST / PUT / DELETE: en el cuerpo JSON de la petición.
  • GET: como parámetro de consulta.
bash
# POST example
curl -X POST https://api.revolink.link/apiv1/link/create \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: rvlnk_your_api_key_here" \
  -d '{
    "workspaceId": "your_workspace_id",
    "name": "My link",
    "rules": [
      {
        "id": "rule-1",
        "targetUrl": "https://example.com",
        "isDefault": true
      }
    ]
  }'

Errores de autenticación

Estado HTTPCuerpo de la respuestaCausa
401{"error": "API key is required. Pass it in the X-Api-Key header."}Falta la cabecera X-Api-Key
401{"error": "Invalid API key."}La clave no coincide con ningún usuario
400{"error": "workspaceId is required."}No se indicó workspaceId
400{"error": "Invalid workspaceId format."}workspaceId no es un ObjectId válido
404{"error": "Workspace not found."}No existe ningún espacio de trabajo con ese ID
403{"error": "You do not have access to this workspace."}El propietario de la clave de API no es miembro ni propietario del espacio de trabajo
403{"licenseExpired": true, "error": "The workspace license has expired."}El plan del espacio de trabajo ha caducado

Cuerpos de las respuestas

Los cuerpos de las respuestas de la API están siempre en inglés, tal como los devuelve el servidor. Aquí solo se traduce la columna «Causa».