Documentación de la API de arText
Envía un texto y recibe un informe estructurado con las métricas calculadas, los problemas lingüísticos encontrados y, cuando existen, sustituciones o cambios aplicables.
El género elegido decide qué se revisa: cada uno tiene su propia selección de reglas, sus umbrales y sus glosarios. No se envían metric_id en POST /v1/reports; basta con indicar el ámbito y el tipo de texto.
Flujo de integración
Elección del género
GET /v1/text-types devuelve los ámbitos con sus tipos de texto; cada uno trae en report_defaults el par que hay que reenviar.
Creación del informe
Se envía el texto, el idioma y el género (domain_slug + text_type_slug); la API responde 202 con status_url.
Espera del resultado
Mediante SSE o consultando status_url conforme a Retry-After hasta completed o failed.
Consumo del informe
Métricas, problemas, fragmentos y cambios disponibles en un JSON estable, con el género aplicado declarado en la respuesta.
Ámbitos y géneros
El catálogo tiene dos niveles. Elegir bien el género es la decisión que más afecta al resultado: determina qué se revisa y con qué exigencia.
Ámbito (domain_slug)
La materia: medicina, administración pública, turismo, ámbito académico o lenguaje claro. Agrupa géneros que comparten materia y, cuando procede, glosarios.
Género (text_type_slug)
El tipo de texto concreto dentro de ese ámbito: una historia clínica, una alegación, un texto médico dirigido a la ciudadanía. Es lo que se analiza.
Cada género trae su propia selección de reglas, sus umbrales y sus glosarios, definidos por el equipo lingüístico. Dos géneros del mismo ámbito pueden revisarse de forma distinta: una historia clínica no se juzga con los criterios de un texto dirigido a la ciudadanía. Por eso el par no es una etiqueta descriptiva, sino la configuración con la que se analiza el texto.
Secciones de esta documentación
Autenticación
Las integraciones directas requieren una clave activa. Envíala en la cabecera Authorization y no la incluyas en código público ni en aplicaciones cliente.
Authorization: Bearer art_live_…