Actualizar un material

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

Actualiza un material. Envíe el material completo: el cuerpo sigue las mismas reglas de la creación.

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

Ejemplo: MmVkNjY1OTYtNTY1ZC00NjQxLTk0YzktNmVhZWYzMTE0MDNiOjIyOTE1.

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.

namestringobligatorio

Nombre del material. En las cuentas que migraron los materiales a productos, el límite es de hasta 100 caracteres, sin mínimo.

De 10 a 150 caracteres.

measurestringobligatorio

Unidad de medida. Los valores fuera de esta lista se guardan como unity.

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

archivedboolean

Archiva el material.

Predeterminado: false.

Respuestas

• 200

  Material actualizado. Si el identificador es válido pero el material no existe, no se cambia nada y la respuesta es 200 con cuerpo vacío.

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

• 422

  Cuerpo inválido (resourceValidationErr). Un identificador inválido o de otra cuenta en la URL también devuelve este error, con property: '@.id'.

• 429

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

• 500

  Error inesperado en el servidor.