Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/fuentes/{espacio}/fuentes/{fuente}/lanzar

Lanza una fuente

Lee las páginas de la fuente y publica lo leído en los documentos del espacio. Si ya hay una corrida en la cola, te devuelve esa.

  • PERMISOescribe
  • CRÉDITOSgasta créditos
  • 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 202

CAMPOTIPOQUÉ ES
run_idstringLa corrida.
status"recibido"En la cola.

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

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Fuentesmódulo no habilitado para este espacio.
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.
402La cuenta agotó sus créditos del cicloLa cuenta de este espacio agotó sus créditos de este ciclo.
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.

CONVIENE SABER