Autenticación #

Cada petición a la API v2 necesita dos cosas: una clave de API y el espacio de trabajo en el que actúa.

URL base #

https://api.revolink.link/apiv2

La especificación OpenAPI 3.1 está en https://api.revolink.link/apiv2/openapi.json y la documentación interactiva en https://api.revolink.link/apiv2/docs.

Cómo obtener tus credenciales #

1. Abre la aplicación Revolink y ve a Perfil → API.
2. Crea una clave de API y elige los permisos que necesita. Copia la clave: solo se muestra una vez.
3. Copia el ID de tu espacio de trabajo.

Enviar la clave de API #

Envía la clave como token Bearer. La cabecera X-Api-Key también se acepta.

Authorization: Bearer rvlnk_your_api_key_here

Enviar el espacio de trabajo #

Envía el ID del espacio de trabajo en la cabecera X-Workspace-Id en cada petición. El propietario de la clave debe ser miembro del espacio de trabajo.

A diferencia de la API v1, el espacio de trabajo se lee solo de esta cabecera, nunca del cuerpo de la petición ni de la cadena de consulta.

curl https://api.revolink.link/apiv2/me \
  -H "Authorization: Bearer rvlnk_your_api_key_here" \
  -H "X-Workspace-Id: your_workspace_id"

GET /me devuelve el usuario, el espacio de trabajo y los permisos de la clave, así que es una buena primera petición para comprobar tu configuración.

Permisos #

Una clave tiene permisos (scopes). Un endpoint responde 403 con error.requiredPermission cuando la clave no tiene el que necesita.

Límite de peticiones #

300 peticiones por minuto por clave de API. Al superarlo, la API responde 429 con la cabecera Retry-After.

Consulta Errores para ver el formato y los códigos de error.