Saltar al contenido principal

Actualizar un tipo de producto

PUThttps://carchost.fieldcontrol.com.br/products-types/{id}

Actualiza un tipo de producto. Envíe el tipo 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 tipo de producto.

Ejemplo: MmY5ZGE5YzgtZDY3MC00NWJhLTk0MGUtNzQxYjk3ODI0MzllOjIyOTE1.

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 tipo de producto.

Hasta 100 caracteres.

descriptionstring

Descripción del tipo de producto.

Hasta 2000 caracteres.

archivedbooleanobligatorio

Archiva el tipo de producto.

externalobject
Campos de external
idstring

Identificador del tipo de producto en su sistema.

Hasta 100 caracteres.Acepta: null.

Respuestas

  • 200

    Tipo de producto actualizado.

  • 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

    Identificador inválido o de otra cuenta en la URL (uriValidationErr), tipo de producto inexistente (resourceValidationErr con message: products type not found; no hay 404) o cuerpo inválido.

    resourceValidationErr →
  • 429

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

  • 500

    Error inesperado en el servidor.