Saltar al contenido principal

Agregar un colaborador secundario a la actividad

POSThttps://carchost.fieldcontrol.com.br/tasks/{id}/secondary-employees/{employeeId}

Agrega un colaborador para acompañar al responsable en la actividad. Devuelve el colaborador. No tiene cuerpo; la respuesta de éxito usa el estado 200.

Requiere los headers X-Api-Key y User-Agent. Límite: 1 solicitud por segundo (más información).

Solicitud​

Parámetros de ruta

idstringobligatorio

Identificador de la actividad.

Ejemplo: ZTllZjFiNzUtOGQ3MS00ZmE1LWFjNmUtYzlmNGQ1YzJiOWI3OjIyOTE1.

employeeIdstringobligatorio

Identificador del colaborador.

Ejemplo: MTY1NDk6MjI5MTU=.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Respuestas

  • 200

    Colaborador agregado.

  • 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

    Actividad o colaborador inexistentes. Sin cuerpo.

  • 422

    Regla de colaboradores secundarios violada (resourceValidationErr): colaborador ya agregado o no agregado a la actividad, igual al responsable, actividad sin responsable o colaborador inexistente. Identificador inválido: uriValidationErr.

  • 429

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

  • 500

    Error inesperado en el servidor.