Atualizar um material

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

Atualiza um material. Envie o material completo: o corpo segue as mesmas regras da criação.

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 material.

Exemplo: MmVkNjY1OTYtNTY1ZC00NjQxLTk0YzktNmVhZWYzMTE0MDNiOjIyOTE1.

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 material. Em contas que migraram materiais para produtos, o limite é de até 100 caracteres, sem mínimo.

De 10 a 150 caracteres.

measurestringobrigatório

Unidade de medida. Valores fora desta lista são gravados como unity.

Valores aceitos: unity, centimeter, meter, liter, milliliter.

archivedboolean

Arquiva o material.

Padrão: false.

Respostas

• 200

  Material atualizado. Se o identificador é válido mas o material não existe, nada é alterado e a resposta é 200 com corpo vazio.

• 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.

• 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.