Saltar al contenido principal

Actualizar un tipo de equipo

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

Actualiza un tipo de equipo. 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 equipo.

Ejemplo: NDFkNzk3MDctZDI3Yy00ZTM1LWJmZGQtYTNhMTUwNzEwNmNkOjIyOTE1.

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 equipo. Debe ser único en la cuenta, sin distinguir mayúsculas y minúsculas.

De 3 a 100 caracteres.

archivedboolean

Archiva el tipo de equipo.

Predeterminado: false.

externalobject
Campos de external
idstring

Identificador del tipo de equipo en su sistema.

Hasta 100 caracteres.Acepta: null.

Respuestas

  • 200

    Tipo de equipo 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.

  • 404

    Recurso no encontrado. El cuerpo de la respuesta está vacío.

  • 409

    Ya existe un tipo de equipo con el mismo nombre en la cuenta, incluidos los archivados (resourceAlreadyExists).

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