Saltar al contenido principal

Modificar respuestas de un formulario

PUThttps://carchost.fieldcontrol.com.br/forms-answers/{id}

Modifica las respuestas de preguntas de un formulario. No funciona en formularios de órdenes bloqueadas.

Requiere los headers X-Api-Key, User-Agent y Content-Type: application/json. Límite: 1 solicitud por segundo (más información).

Solicitud​

Parámetros de ruta

idstringobligatorio

Identificador del formulario respondido.

Ejemplo: ZGY4NzYwYTYtMmQwYi00Mjc3LTliNzMtMjEwOTBiYWVkNDVjOjIyOTE1.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Cuerpo de la solicitud

JSON, enviado con el header Content-Type: application/json.

questionslista de objetosobligatorio

Respuestas que se modificarán. Las demás preguntas mantienen la respuesta actual.

Campos de questions
idstringobligatorio

Identificador de la pregunta.

answerstringobligatorio

Nueva respuesta, validada según el tipo de la pregunta (p. ej. opción existente, fecha, número).

Mínimo de 1 caracteres.

Respuestas

  • 200

    Respuestas modificadas.

  • 401

    Clave de API ausente (Missing API Key) o inválida (Invalid API Key). Consulte Autenticación.

  • 403

    Cuenta bloqueada (Account blocked), vencida (Account expired) o con un plan que no permite integración (Account plan not allowed). Consulte Autenticación.

  • 404

    Recurso no encontrado. El cuerpo de la respuesta está vacío.

  • 422

    Cuerpo inválido (resourceValidationErr): pregunta que no es del formulario o respuesta incompatible con el tipo; orden bloqueada (resourceLockedErr); identificador inválido (uriValidationErr).

  • 429

    Se superó el límite de 1 solicitud por segundo. Consulte Límite de solicitudes.

  • 500

    Error inesperado en el servidor.