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

Cancela la corrida de una fuente

Para la última corrida. Si aún estaba en la cola, se cancela ya; si estaba leyendo, para al acabar el paso en curso.

  • PERMISOescribe
  • 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
run_idstringLa corrida.
statusstringcancelado si ya paró; si no, su estado actual: consulta la fuente.

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
404La fuente nunca se lanzóLa fuente no tiene corridas

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.