Saltar al contenido
API v1 · https://bentho.org/api
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

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Fuentes.
fuentestringSÍEl id de la fuente: el que devolvió crearla (32 caracteres hexadecimales).

RESPUESTA 200

CAMPOTIPOQUÉ ES
id · nombre · temastringLos que diste al crearla.
urls · dominiosstring[]Los tuyos.
campos · limitesarray · objectTambién los tuyos (limites, con sus valores por defecto).
estadostringEl de la última corrida, o lista si nunca se lanzó: ver estados.
paginasintegerPáginas publicadas en la última corrida.
errorstringPor qué falló. Vacío si no falló.
run_idstring | nullLa última corrida; null si ninguna.
actualizadonumberSegundos desde 1970, con decimales.

ESTADOS DE UNA FUENTE

CAMPOTIPOQUÉ ES
listasin lanzarCreada; todavía no se ha lanzado.
recibidoen cursoEn la cola, esperando su turno.
adquirido · normalizadoen cursoLeyendo las páginas y limpiándolas.
estructurado · revisadoen cursoSacando los campos y revisando antes de publicar.
publicadoterminadaLo leído está en los documentos del espacio.
fallidoterminadaNo se pudo: mira error.
canceladoterminadaLa cancelaste.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Fuentesmódulo no habilitado para este espacio.
404No hay una fuente con ese id en el espacioLa 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.