GET
/api/mod/fuentes/{espacio}/fuentes/{fuente}Una fuente y su última corrida
La fuente, con el estado de su última corrida.
- 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. |
| fuente | string | SÍ | El id de la fuente: el que devolvió crearla (32 caracteres hexadecimales). |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id · nombre · tema | string | Los que diste al crearla. |
| urls · dominios | string[] | Los tuyos. |
| campos · limites | array · object | También los tuyos (limites, con sus valores por defecto). |
| estado | string | El de la última corrida, o lista si nunca se lanzó: ver estados. |
| paginas | integer | Páginas publicadas en la última corrida. |
| error | string | Por qué falló, en una frase (Solo se aceptan URLs https, El destino no está en los dominios de la fuente, No se pudo leer la página…) o No se pudo completar la corrida. Vacío si no falló. |
| run_id | string | null | La última corrida; null si ninguna. |
| actualizado | number | Segundos desde 1970, con decimales. |
ESTADOS DE UNA FUENTE
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| lista | sin lanzar | Creada; todavía no se ha lanzado. |
| recibido | en curso | En la cola, esperando su turno. |
| adquirido · normalizado | en curso | Leyendo las páginas y limpiándolas. |
| estructurado · revisado | en curso | Sacando los campos y revisando antes de publicar. |
| publicado | terminada | Lo leído está en los documentos del espacio. |
| fallido | terminada | No se pudo: mira error. |
| cancelado | terminada | La cancelaste. |
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 fuente con ese id en el espacio | La fuente 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.