Autenticación y límites

Cada petición lleva la clave en la cabecera Authorization: Bearer. Las claves empiezan por xyr_live_ (datos reales) o xyr_test_ (pruebas). Xyrelis solo guarda su huella SHA-256: si la pierde, revóquela y cree otra.

Permisos

Uso de la clave

Toda la API necesita clave: sin la cabecera se responde 401 (sin_clave). La única excepción es la especificación https://xyrelis.es/api/v1/openapi.json.

# Guarde la clave en una variable de entorno, nunca en el código ni en el repositorio
export XYR="xyr_live_…"
curl -H "Authorization: Bearer $XYR" https://xyrelis.es/api/v1/yo

/yo (con el permiso parcelas:leer) devuelve la clave en uso (nombre, permisos, entorno y límite efectivo): sirve para comprobar que la clave funciona.

import os, requests
r = requests.get("https://xyrelis.es/api/v1/parcelas", headers={"Authorization": f"Bearer {os.environ['XYR']}"}, timeout=30)
r.raise_for_status()

Límite de peticiones

Cada clave tiene un límite de peticiones por minuto. Si al crearla no se indica, se usa el límite por defecto (ahora 60). Ninguna clave puede pasar del máximo (ahora 600 para su cuenta). NorthDelta puede ajustar el límite de una clave o el tope de una cuenta. Si lo hace, el cambio se aplica en menos de un minuto, sin cambiar de clave.

Cada respuesta trae X-RateLimit-Limit (el límite efectivo) y X-RateLimit-Remaining. Al pasarse se responde 429 con Retry-After (segundos de espera). Espere ese tiempo antes de reintentar.

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
{"error": {"codigo": "limite", "mensaje": "Ha superado el límite de 60 peticiones por minuto."}}

Si necesita más, pídalo a NorthDelta indicando el nombre de la clave.

Errores

{"error": {"codigo": "sin_permiso", "mensaje": "La clave no tiene el permiso «cuaderno:escribir»."}}