Modificar respuestas de un formulario de la orden

PUThttps://carchost.fieldcontrol.com.br/orders/{id}/forms/{formId}

Modifica las respuestas de preguntas de un formulario de la orden de servicio. No funciona en ó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 de la orden de servicio.

Ejemplo: NDJiMWQ0YzQtOWNmOC00NWE2LTg2MjItYjNjNzZjZjk0MmM4OjIyOTE1.

formIdstringobligatorio

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

  Orden o formulario inexistentes, o formulario de otra orden. Sin cuerpo.

• 422

  Cuerpo inválido (resourceValidationErr): pregunta que no es del formulario (reason: not found) o respuesta incompatible con el tipo de la pregunta; 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.