Respuestas de formularios

Respuestas de formularios

Endpoint principal

  • GET /api/urformanswer/
  • GET /api/urformanswer/<answer_id>/
  • PATCH /api/urformanswer/<answer_id>/

Endpoint de archivos asociados a respuestas

  • GET /api/answerfile/
  • POST /api/answerfile/
  • PATCH /api/answerfile/<file_id>/

Endpoint de exportación/consulta tabular

  • GET /api/entryanswerdata/
  • GET /api/entryanswercolumndata/
  • GET /api/formdata/

Campos principales de una respuesta

  • id: identificador de la respuesta.
  • form: formulario al que pertenece.
  • entry: pregunta o entrada del formulario.
  • entry_type: tipo de pregunta.
  • index: indice tecnico de la pregunta dentro del formulario.
  • answer: valor de la respuesta.
  • remarks: comentarios.
  • entry_status: estado de la entrada/respuesta.
  • rejection_status: estado de aprobacion o rechazo, si aplica.
  • rejection_comments: comentario de rechazo, si aplica.
  • when_created, who_created: auditoria de creacion.
  • when_last_edit, who_last_edit: auditoria de ultima edicion.

Filtros útiles

  • form=<id>: respuestas de un formulario.
  • code=<codigo_formulario>: respuestas de un formulario por codigo.
  • template=<id>: respuestas de una plantilla.
  • index=<indice>: respuesta de una pregunta puntual.
  • entry__label=<label>: respuestas por label exacto de pregunta.
  • entry__label__contains=<texto>: respuestas por label parcial.
  • task=<id>: respuestas de formularios asociados a una tarea.
  • project=<id>: respuestas de formularios asociados a un proyecto.
  • sites=<id>: respuestas de formularios asociados a un sitio.
  • status=<id>: formularios por estado.
  • when_created=<YYYY-MM-DD>: fecha de creacion del formulario.
  • when_created__gte=<YYYY-MM-DD> / when_created__lte=<YYYY-MM-DD>: rango de fechas.

Ejemplo de lectura:

curl \
-H "Authorization: Token $SYTEX_TOKEN" \
-H "Organization: 234" \
"https://app.sytex.io/api/urformanswer/?form=12345&limit=100"

Ejemplo de actualización de una respuesta:

curl -X PATCH \
-H "Authorization: Token $SYTEX_TOKEN" \
-H "Organization: 234" \
-H "Content-Type: application/json" \
-d '{"answer": "Valor actualizado"}' \
"https://app.sytex.io/api/urformanswer/98765/"

Importador masivo

  • GET /api/import/EntryAnswerImport/get_config/
  • POST /api/import/EntryAnswerImport/go/

Campos principales del importador

  • form
  • index
  • answer
  • remarks
  • entry_status
  • answer_media
Nota: en la practica, las respuestas suelen existir al crear el formulario. Para integraciones, lo mas habitual es actualizar respuestas existentes por id o por importador usando form + index.