Alterar respostas de um formulário da ordem

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

Altera as respostas de perguntas de um formulário da ordem de serviço. Não funciona em ordens travadas.

Requer os headers X-Api-Key, User-Agent e Content-Type: application/json. Limite: 1 requisição por segundo (saiba mais).

Requisição

Parâmetros de caminho

idstringobrigatório

Identificador da ordem de serviço.

Exemplo: NDJiMWQ0YzQtOWNmOC00NWE2LTg2MjItYjNjNzZjZjk0MmM4OjIyOTE1.

formIdstringobrigatório

Identificador do formulário respondido.

Exemplo: ZGY4NzYwYTYtMmQwYi00Mjc3LTliNzMtMjEwOTBiYWVkNDVjOjIyOTE1.

Headers

User-Agentstringobrigatório

Identificação da sua aplicação.

Exemplo: MinhaIntegracao/1.0.

Corpo da requisição

JSON, enviado com o header Content-Type: application/json.

questionslista de objetosobrigatório

Respostas a alterar. As demais perguntas mantêm a resposta atual.

Campos de questions

idstringobrigatório

Identificador da pergunta.

answerstringobrigatório

Nova resposta, validada conforme o tipo da pergunta (ex. opção existente, data, número).

Mínimo de 1 caracteres.

Respostas

• 200

  Respostas alteradas.

• 401

  Chave de API ausente (Missing API Key) ou inválida (Invalid API Key). Ver Autenticação.

• 403

  Conta bloqueada (Account blocked), expirada (Account expired) ou com plano que não permite integração (Account plan not allowed). Ver Autenticação.

• 404

  Ordem ou formulário inexistentes, ou formulário de outra ordem. Sem corpo.

• 422

  Corpo inválido (resourceValidationErr): pergunta que não é do formulário (reason: not found) ou resposta incompatível com o tipo da pergunta; ordem travada (resourceLockedErr); identificador inválido (uriValidationErr).

• 429

  Limite de 1 requisição por segundo excedido. Ver Limite de requisições.

• 500

  Erro inesperado no servidor.