Pular para o conteúdo principal

Adicionar um colaborador secundário à atividade

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

Adiciona um colaborador para acompanhar o responsável na atividade. Retorna o colaborador. Não tem corpo; a resposta de sucesso usa o status 200.

Requer os headers X-Api-Key e User-Agent. Limite: 1 requisição por segundo (saiba mais).

Requisição​

Parâmetros de caminho

idstringobrigatório

Identificador da atividade.

Exemplo: ZTllZjFiNzUtOGQ3MS00ZmE1LWFjNmUtYzlmNGQ1YzJiOWI3OjIyOTE1.

employeeIdstringobrigatório

Identificador do colaborador.

Exemplo: MTY1NDk6MjI5MTU=.

Headers

User-Agentstringobrigatório

Identificação da sua aplicação.

Exemplo: MinhaIntegracao/1.0.

Respostas

  • 200

    Colaborador adicionado.

  • 401

    Chave de API ausente (Missing API Key) ou inválida (Invalid API Key). Ver Autenticação.

  • 403

    Conta bloqueada (Account blocked), expirada (Account expired) ou com plano que não permite integração (Account plan not allowed). Ver Autenticação.

  • 404

    Atividade ou colaborador inexistentes. Sem corpo.

  • 422

    Regra de colaboradores secundários violada (resourceValidationErr): colaborador já adicionado ou não adicionado à atividade, igual ao responsável, atividade sem responsável ou colaborador inexistente. Identificador inválido: uriValidationErr.

  • 429

    Limite de 1 requisição por segundo excedido. Ver Limite de requisições.

  • 500

    Erro inesperado no servidor.