Autenticación de la API
Autentica las solicitudes a la API y concede el acceso necesario para cada operación.
Envía una clave de API de Lingo.dev en la cabecera 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 gestor de secretos. No la incluyas en repositorios, paquetes de código para el navegador, URL ni documentos de origen.
Elige una credencial #
Una clave personal actúa según la pertenencia a organizaciones y los permisos que tenga su usuario en ese momento. Una clave de servicio de organización pertenece a la organización y es adecuada para servicios que funcionan sin intervención humana. Los permisos concedidos por rol y por recurso determinan su acceso; una concesión explícita más limitada no reduce el acceso que ya otorga su rol.
La API también acepta como Authorization: Bearer <access-token> el token de acceso de la sesión de un usuario que haya iniciado sesión. 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 estas acciones deben identificar a una persona.
Usa un único método de autenticación por solicitud. Los nombres de las cabeceras no distinguen entre mayúsculas y minúsculas.
Selecciona la organización y el motor #
Las rutas cuyo ámbito es una organización incluyen orgId en la ruta. Para encontrar los ID de organización correspondientes a un usuario o una clave personal, consulta GET /v2/users/me/memberships. Si usas una clave de servicio, utiliza la organización a la que pertenece. Los ID de motor identifican el motor configurado en Studio; obtén la lista de motores accesibles con GET /v2/organizations/:orgId/engines.
Para crear, iniciar, consultar y descargar un trabajo de localización, necesitas acceso a su organización y acceso de traducción a su motor. El aprovisionamiento requiere permisos 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.
Indicar un ID de organización o de motor no concede acceso. Un recurso fuera del ámbito de quien realiza la llamada puede devolver 404. Por eso, si no se encuentra un recurso conocido, comprueba tanto el ID como los permisos de quien realiza la llamada.
Diagnostica un fallo de acceso #
Consulta tanto la respuesta de problema como su estado HTTP. Un 401 indica que falta una credencial, que no es válida o que ha caducado. Un 402 señala una condición relacionada con la facturación o el plan, incluida la desactivación de una clave de servicio tras una reducción del nivel de RBAC. Un 403 indica que se ha denegado un permiso o que se requiere una identidad de usuario. Los problemas de configuración del motor y los límites de la cuenta deben corregirse por separado.
Conserva el type del problema, el estado y los ID de recursos que no sean secretos para facilitar el diagnóstico. Nunca registres la cabecera de autenticación.
Rota una clave #
Crea una clave de sustitución, concede el acceso necesario y actualiza el secreto del servicio. Antes de revocar la clave anterior, comprueba que la nueva permite recuperar un trabajo existente y descargar un resultado. Conserva los ID de los trabajos que hayas registrado: la rotación de credenciales no cambia la identidad de los trabajos.