GET
/api/mod/fuentes/{espacio}/fichas/{ficha}/markdownLa ficha armada y cómo se armó
El markdown de la ficha y su traza: qué páginas leyó, cuántos campos llenó, por qué paró de buscar y si se publicó.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Fuentes. |
| ficha | string | SÍ | El id de la ficha: el que devolvió armarla (32 caracteres hexadecimales). |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| tema | string | El tema. |
| markdown | string | La ficha: cada campo con su valor, su Fuente y su Cita literal. Los vacíos dicen «sin respaldo en las páginas leídas». |
| pages | integer | Páginas leídas. |
| traza.campos · llenos | integer | Campos de la plantilla y cuántos llenó. |
| traza.completitud | number | La fracción llena, de 0 a 1. |
| traza.paginas[] | { url, tipo, caracteres, pasajes, sobre_tema } | Cada página leída y si trataba el tema. |
| traza.rondas[] | { ronda, consultas, nuevas } | Cada vuelta de búsqueda: qué buscó y cuántas páginas nuevas encontró. |
| traza.paginas_leidas | integer | Las páginas que leyó. |
| traza.paginas_con_texto | integer | Las que tenían algo útil. |
| traza.motivo_cierre | string | Por qué dejó de buscar: completa, rondas, paginas, tiempo… |
| traza.sugerencia | string | Solo si llenó menos de la mitad sin urls tuyas: qué aportar. |
| traza.publicacion | { status, document_id, version, unidades } | Si llegó a los documentos del espacio: published, sin_datos (ningún campo lleno, no publica nada) o fallida. |
| traza.segundos | number | Lo que tardó en armarse. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Fuentes | módulo no habilitado para este espacio. |
| 404 | No hay una ficha con ese id en el espacio | La ficha no existe |
| 409 | La ficha no está en publicado (aún se arma, o falló) | La ficha todavía no está armada |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- En los documentos del espacio la ficha se llama
ficha-<tema>.mdy va cortada en trozos que se entienden solos, para que Bentho la use al responder. - La traza trae más campos de uso interno: no te apoyes en ellos.