Autenticación

La API se autentica con una clave de API del equipo enviada como token de portador (bearer token). Cada clave está limitada a un solo equipo y un solo entorno.

Claves de API

Genera claves en Equipos → Claves de API. Una clave se muestra completa una sola vez — solo se guarda un hash SHA-256 de nuestro lado. Envíala como token de portador en el encabezado que se muestra a continuación:

curl https://api.seeitlive.io/v1/sessions \
  -H "Authorization: Bearer sil_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Entornos

Cada clave pertenece a uno de dos entornos, identificado por su prefijo:

Las sesiones creadas con una clave heredan el entorno y el equipo de esa clave.

Proteger una clave

Cada clave se puede restringir para que una clave filtrada resulte inútil desde el lugar equivocado:

• Fuentes permitidas — Restringe una clave por IP, rango CIDR o nombre de host — uno por línea. Los nombres de host se resuelven por DNS y se comparan con la IP de quien llama. Añade una etiqueta en línea después de # o ;, por ejemplo 1.2.3.4/24 # servidor 1.
• Expiración — Asigna a una clave una fecha de expiración. Una vez pasada, las solicitudes que usen esa clave se rechazan.
• Revocar — Desactiva una clave al instante — las solicitudes en curso empiezan a fallar de inmediato.

Firma de solicitudes

La firma es opcional y se suma a la autenticación por clave — el encabezado Authorization: Bearer sigue siendo obligatorio en cada solicitud. Actívala, rótala o desactívala para una clave desde Equipo → Claves de API → la clave → Seguridad; activarla o rotarla revela el secreto de firma una sola vez, así que guárdalo de inmediato.

Una vez activada, firma cada solicitud calculando HMAC_SHA256(signingSecret, "TIMESTAMP.METHOD.PATH.sha256hex(body)"), codificado en hexadecimal, donde:

Envía la firma y la marca de tiempo como encabezados en cada solicitud firmada:

SIGNING_SECRET=your-signing-secret   # shown once when you enable signing
TS=$(date +%s)
BODY='{"channel":"demo"}'
BODY_HASH=$(printf '%s' "$BODY" | openssl dgst -sha256 | sed 's/^.* //')
SIG=$(printf '%s' "$TS.POST./sessions.$BODY_HASH" | openssl dgst -sha256 -hmac "$SIGNING_SECRET" | sed 's/^.* //')
curl https://api.seeitlive.io/v1/sessions \
  -H "Authorization: Bearer sil_live_xxxxxxxx" \
  -H "X-SeeItLive-Timestamp: $TS" \
  -H "X-SeeItLive-Signature: sha256=$SIG" \
  -H "Content-Type: application/json" \
  -d "$BODY"

Límites de solicitudes

La API permite 100 solicitudes por minuto por clave. Los endpoints de creación de sesión y de entrega de invitaciones tienen límites más estrictos. Superar un límite devuelve 429 — consulta la referencia de errores completa para conocer todos los códigos de estado que puede devolver la API.