Pular para o conteúdo principal

Atualizar um tipo de OS

PUThttps://carchost.fieldcontrol.com.br/services/{id}

Atualiza um tipo de OS. O corpo segue as mesmas regras da criação; archived omitido mantém o valor atual.

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 do tipo de OS.

Exemplo: MTk6MjI5MTU=.

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.

namestringobrigatório

Nome do tipo de OS.

De 5 a 100 caracteres.

durationintegerobrigatório

Duração estimada do atendimento, em minutos.

De 0 a 2147483647.

archivedboolean

Arquiva o tipo de OS.

Padrão: false.

Respostas

  • 200

    Tipo de OS atualizado.

  • 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

    Recurso não encontrado. O corpo da resposta é vazio.

  • 422

    Corpo inválido (resourceValidationErr). Um identificador inválido ou de outra conta na URL também retorna este erro, com property: '@.id'.

  • 429

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

  • 500

    Erro inesperado no servidor.