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

Cancela la versión en curso

Para la versión que se está escribiendo o que espera datos. Las versiones terminadas no cambian.

  • 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 Landings.
landingstringSÍEl id de la landing: el que devolvió crearla (32 caracteres hexadecimales).

RESPUESTA 200

CAMPOTIPOQUÉ ES
idstringLa landing.
status"cancelado" | "cancelando"cancelado: ya está parada (o no había nada en curso). cancelando: se para al acabar el paso en curso; consulta el estado.

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

STATUSCUÁNDODETAIL LITERAL
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.
403El espacio no tiene el módulo Landingsmódulo no habilitado para este espacio.
404No hay una landing con ese id en el espacio (o se borró)La landing 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

  • No gasta créditos y funciona aunque la bolsa esté agotada. Lo que la versión ya gastó no se devuelve.