​

Solución de problemas: autenticación y claves de API

Cada solicitud a Orbit pasa por controles de credenciales, caducidad y revocación, modo sandbox/live, lista de IP y permisos. Lee code: varios controles pueden compartir el mismo estado HTTP.

​

Errores 401

Para UNAUTHORIZED, confirma el encabezado X-API-Key y envía la clave completa. INVALID_API_KEY indica una clave desconocida, revocada o bloqueada por una lista de IP de la clave. Cópiala de nuevo en Settings → API Keys o crea un reemplazo. EXPIRED_TOKEN indica que venció la fecha o revoke_at; rota la clave.

​

Sandbox y live

Una clave dv_test_sk_ debe usarse en sandbox y una dv_live_sk_ en live. La combinación incorrecta devuelve 403 WRONG_KEY_MODE antes del handler. Crea la clave en la organización que estás llamando.

​

Listas de IP

Una IP bloqueada por la clave aparece deliberadamente como 401 INVALID_API_KEY. La lista de la organización devuelve 403 IP_NOT_ALLOWED. Comprueba la IP pública de salida que ve Orbit y añade esa IP o su rango CIDR en la configuración de seguridad.

​

Claves públicas y SAML/SCIM

Las claves públicas son de solo lectura. Usa una clave secreta en tu backend para escrituras como messages:write. En SAML, el usuario debe pertenecer a la organización; SCIM no puede superar el límite de roles configurado. Nunca envíes el secreto a soporte. Incluye el código, request_id y solo el prefijo de la clave.