Saltar al contenido principal

Actualizar un servicio

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

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

También se acepta un identificador de producto, y el registro pasa a ser un servicio.

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

Ejemplo: NmIzYWU1NGItN2IxNi00NzQ2LTg4ZmUtOGM2ZjY3YzlhOTMxOjIyOTE1.

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

Hasta 100 caracteres.

descriptionstring

Descripción del servicio.

Hasta 2000 caracteres.

valuenumberobligatorio

Valor unitario del servicio.

archivedbooleanobligatorio

Archiva el servicio.

externalobject
Campos de external
idstring

Identificador del servicio en su sistema.

Hasta 100 caracteres.Acepta: null.

Respuestas

  • 200

    Servicio 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), servicio inexistente (resourceValidationErr con message: work service 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.