GET
/api/mod/fuentes/{espacio}/fichas/{ficha}El estado de una ficha
La ficha con su estado. La ruta que consultas mientras se arma.
- 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 |
|---|---|---|
| id · tema | string | El id y el tema. |
| status | string | Su estado: ver estados. |
| pages | integer | Páginas leídas. |
| error | string | Por qué falló, en una frase: No se encontró ninguna página para el tema, No se pudo buscar el tema, La búsqueda no devolvió páginas o El buscador no respondió; cualquier otro fallo, No se pudo armar la ficha. Mientras el buscador no responde, la ficha vuelve a la cola y dice esperando al buscador. Vacío si no falló. |
| cuenta | string | La cuenta que la pidió. |
| created_at · updated_at | number | Segundos desde 1970, con decimales. |
| urls | string[] | Las que diste al armarla. |
| como | object | Las opciones con que se arma: las de como que mandaste. |
| markdown | string | La ficha, cuando está publicada. Vacío antes. |
ESTADOS DE UNA FICHA
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| recibido | en curso | En la cola, esperando su turno. |
| armando | en curso | Buscando, leyendo y llenando campos. |
| publicado | terminada | Armada. Lo que encontró, en GET …/markdown; si ya está en los documentos del espacio, en traza.publicacion. |
| fallido | terminada | No se pudo armar: mira error. |
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 |
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
- Consulta cada 10 a 15 s. Para cuando
statusseapublicadoofallido.