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

Responde a lo que falta

Cuando una versión queda en esperando_datos, mandas aquí lo que tu usuario responda a sus faltantes y la versión sigue.

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

CUERPO · JSON

CAMPOTIPOREQUERIDOQUÉ ES
respuestas{ clave: texto }noUna respuesta por clave de faltantes. Hasta 4000 caracteres cada una. Se añaden al brief.
omitirstring[]noLas claves que tu usuario no tiene o no quiere dar. Esa parte se escribe sin ese dato, y sin decirle al visitante que falta.

RESPUESTA 202

CAMPOTIPOQUÉ ES
id · versionstring · integerLa landing y la versión que sigue.
status"pendiente"Vuelve a la cola.
aportadosstring[]Las claves que respondiste.
declinadosstring[]Las que omitiste o dejaste sin responder.

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

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Landingsmó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 landing con ese id en el espacio (o se borró)La landing no existe
409Ninguna versión está en esperando_datosLa landing no está esperando datos.
422Una clave que no está en faltantesClaves desconocidas: …
422respuestas no es un objeto de textos, o uno pasa de 4000 caracteresrespuestas debe ser un objeto {clave: texto} de hasta 4000 caracteres por respuesta

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

  • Lo que no respondas ni omitas cuenta como omitido: un cuerpo vacío sigue sin ninguno de esos datos.
  • Responde enseguida: el trabajo sigue en segundo plano y suele tardar unos minutos. Sigue la versión con GET landings/{landing}.