Autenticación de la API
Autentica las solicitudes a la API y otorga el acceso necesario para cada operación.
Envía una clave de API de Lingo.dev en el encabezado X-API-Key. Usa https://api.lingo.dev/v2 como URL base para las referencias de la API de esta sección.
GET /v2/organizations/YOUR_ORGANIZATION_ID/localization/jobs HTTP/1.1
Host: api.lingo.dev
X-API-Key: YOUR_API_KEYCrea una clave desde Claves de API. Guárdala en el entorno de tu servidor o en un administrador de secretos. No la incluyas en repositorios, paquetes de código para el navegador, URLs ni documentos de origen.
Elige una credencial #
Una clave personal utiliza la membresía y los permisos actuales de su usuario. Una clave de servicio pertenece a la organización y es adecuada para servicios que funcionan sin intervención humana. Los permisos otorgados por rol y por recurso determinan su acceso; un permiso explícito más restringido no reduce el acceso que ya otorga su rol.
La API también acepta el token de acceso de la sesión de un usuario que haya iniciado sesión como Authorization: Bearer <access-token>. Un revisor puede usar su sesión de usuario o su clave personal para enviar decisiones de revisión. Las claves de servicio no pueden tomar decisiones de revisión humana, ya que esas acciones deben identificar a una persona.
Usa un solo método de autenticación por solicitud. Los nombres de los encabezados no distinguen entre mayúsculas y minúsculas.
Selecciona la organización y el motor #
Las rutas específicas de una organización incluyen orgId en la ruta. Para encontrar los IDs de las organizaciones de un usuario o una clave personal, consulta GET /v2/users/me/memberships. Si usas una clave de servicio, usa la organización a la que pertenece. Los IDs de los motores identifican el motor configurado en Studio; consulta la lista de motores accesibles con GET /v2/organizations/:orgId/engines.
Crear, iniciar, consultar y descargar un trabajo de localización requiere acceso a su organización y acceso de traducción a su motor. El aprovisionamiento requiere permiso para editar o crear el motor y para crear las directrices solicitadas. La revisión de traducciones se rige por los permisos y las reglas de asignación del revisor.
Enviar un ID de organización o de motor no otorga acceso. Un recurso fuera del alcance de quien realiza la solicitud puede devolver 404. Por eso, si no se encuentra un recurso conocido, confirma tanto el ID como los permisos de quien realiza la solicitud.
Diagnostica un error de acceso #
Consulta tanto la respuesta del problema como su código de estado HTTP. Un 401 indica que falta una credencial, que no es válida o que venció. Un 402 señala una condición de facturación o del plan, incluida una clave de servicio deshabilitada tras un cambio a un nivel inferior de RBAC. Un 403 indica que se denegó un permiso o que se requiere una identidad de usuario. La configuración del motor y los límites de la cuenta requieren correcciones específicas.
Conserva el type del problema, el código de estado y los IDs de recursos que no sean secretos para facilitar el diagnóstico. Nunca registres el encabezado de autenticación.
Rota una clave #
Crea la clave de reemplazo, otorga el acceso necesario y actualiza el secreto del servicio. Verifica que la nueva clave permita recuperar un trabajo existente y descargar un resultado antes de revocar la anterior. Conserva los IDs de trabajos que tengas guardados: rotar las credenciales no cambia la identidad de los trabajos.