Vincular Usuário a Empresa(s). - API Zen 2

Este endpoint permite criar vínculos entre um usuário específico e uma ou mais empresas.
O vínculo é criado a partir do Id do usuário e uma lista de IDs de empresas.

Validações:

O Id do usuário deve ser válido e existir no sistema.

A lista de empresas não pode estar vazia.

Caso a validação falhe, a operação será abortada e um erro de validação será retornado.

Respostas:

Sucesso: Retorna uma confirmação do vínculo realizado com sucesso.

Falha: Detalha erros, como parâmetros inválidos ou não encontrados.

Exemplo de Requisição (Rota):

POST /api/v2/Usuarios/488/Empresas/Vincular

Onde 488 é o UsuarioId que será vinculado às empresas.

Exemplo de Requisição (Body JSON):

{
  "EmpresasId": [1, 2, 3]
}

Validações Executadas:

O campo UsuarioId é obrigatório e deve ser um número válido.

O campo EmpresasId é obrigatório e deve conter ao menos um ID de empresa válido.

Exemplo de Resposta de Sucesso:

{
 "sucesso": true,
  "mensagem": "As empresas foram associadas ao usuário com sucesso.",
  "dados": null
}

Exemplo de Resposta de Erro:

{
 "sucesso": false,
  "mensagem": "Parâmetros inválidos fornecidos, como falta de Id de usuário ou lista de empresas vazia.",
  "dados": null
}

curl --location --request POST '/v2/Usuarios//Empresas/Vincular' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "empresasId": [ 1, 2, 3 ] }'