Canjear código de emparejamiento por clave

POST 
/keys/exchange

El sitio presenta el código emitido en el panel y recibe su propia API key. Llamada servidor a servidor, sin credencial previa: el código es la credencial y vale una vez.

La clave sale vinculada al sitio (siteId) y con los permisos de un sitio conectado. Un código inexistente, vencido, ya usado o emitido para otra dirección, y un cuerpo inválido, reciben la misma respuesta, 401 pairing_invalid: desde fuera no se puede distinguir un caso de otro. Límite de 20 intentos cada 10 minutos por IP.

Request

Responses

201

Clave emitida.

401

Token ausente, mal formado, desconocido o revocado (authentication), o cuenta suspendida (tenant_inactive).

429

Límite de peticiones superado (rate_limit).

Response Headers

Retry-After

Segundos a esperar antes de reintentar.

X-RateLimit-Category

Categoría de límite aplicada — send, media o default.

X-RateLimit-Scope

Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).

X-RateLimit-Limit

Techo de peticiones de la categoría en la ventana actual.

X-RateLimit-Remaining

Peticiones restantes en la ventana actual.