Listar traducciones
Las más recientes primero, excluyendo las archivadas por defecto. La paginación se basa en cursores: pase el next_cursor de la respuesta anterior textualmente. No se admiten offsets porque una traducción creada durante la paginación los desplazaría silenciosamente. search coincide con el nombre de una traducción o, si no tiene, con el nombre del archivo subido: es la misma búsqueda que utiliza la lista de lotes de la aplicación web, por lo que los resultados nunca divergen.
GET/v1/batches
Requiere batches:read. Las traducciones archivadas se excluyen por defecto. Envía next_cursor sin cambios para obtener la siguiente página.
Filtra con status, archived, quality_tier, created_after y created_before. search coincide con el nombre de una traducción o, si no tiene, con el nombre del archivo subido. Es la misma búsqueda que utiliza la lista de la aplicación web, por lo que ambas nunca discrepan.
Este endpoint solo realiza lecturas: no inicia una traducción y no consume créditos. Lista cada traducción en el espacio de trabajo, independientemente de la interfaz que la haya creado. Para iniciar una, crea una traducción.
Autorizaciones
Authorizationbearerin headerrequiredParámetros de consulta
limitintegerrange: 1–100Número de elementos a devolver. Los valores fuera del rango 1-100 se limitan, y la respuesta indica el límite aplicado realmente.
cursorstringstatusenum<string>one of: analyzing, awaiting_instructions, awaiting_approval, translating, completed, failed, cancelledMantiene solo las traducciones en este estado. awaiting_instructions y awaiting_approval significan ambos 'esperando a que actúes', pero requieren llamadas distintas, por lo que se filtran por separado. cancelled también se filtra independientemente de failed: una cancelación no es un fallo, por lo que para contar las ejecuciones fallidas se debe solicitar solo failed.
archivedenum<string>one of: 0, 1, true, falsequality_tierenum<string>one of: standard, litecreated_afterstringcreated_beforestringsearchstringlength: 1–200 charsRespuesta
Listar traducciones
dataobject[]requiredhas_morebooleanrequirednext_cursorstringnullrequiredlimitintegerrequiredrequest_idstringrequiredCódigos posibles: invalid_request, unknown_field, invalid_parameter, invalid_cursor
errorobjectrequiredrequest_idstringrequiredCódigos posibles: authentication_required, invalid_api_key, api_key_expired, api_key_revoked
errorobjectrequiredrequest_idstringrequiredCódigos posibles: insufficient_credits
errorobjectrequiredrequest_idstringrequiredCódigos posibles: insufficient_scope, feature_not_available, admin_required, file_retention_expired
errorobjectrequiredrequest_idstringrequiredCódigos posibles: batch_not_found, glossary_not_found, resource_not_found
errorobjectrequiredrequest_idstringrequiredCódigos posibles: glossary_already_exists, result_not_ready, batch_not_editable, idempotency_key_reused, no_plan_yet, plan_changed, batch_not_awaiting_approval
errorobjectrequiredrequest_idstringrequiredCódigos posibles: file_expired
errorobjectrequiredrequest_idstringrequiredCódigos posibles: request_too_large, file_too_large, result_too_large
errorobjectrequiredrequest_idstringrequiredCódigos posibles: language_not_supported, invalid_language_pair, glossary_term_limit_reached, glossary_limit_reached, invalid_glossary_terms, unsupported_format, file_fetch_failed, plan_invalid
errorobjectrequiredrequest_idstringrequiredCódigos posibles: rate_limited
errorobjectrequiredrequest_idstringrequiredCódigos posibles: internal_error
errorobjectrequiredrequest_idstringrequiredCódigos posibles: service_unavailable
errorobjectrequiredrequest_idstringrequired