Chamada API Meu Holerite

Este tutorial explica como preparar o projeto PontoFoPag localmente e validar a chamada da API Meu Holerite usando o Postman.

1. Pré-requisitos

Antes de iniciar, confirme se o ambiente possui:

• Visual Studio 2019 instalado.
• Solução do projeto PontoFoPag aberta no Visual Studio.
• Postman instalado para realizar as chamadas da API.

2. Configurar o Projeto de Inicialização

No Visual Studio 2019:

1. Clique com o botão direito na solução do projeto PontoFoPag.
2. Acesse Propriedades.
3. Selecione o projeto cwkWebAPIPontoWeb como projeto de inicialização.
4. Confirme a alteração.

3. Executar o Projeto

Execute o projeto pelo Visual Studio.

Ao iniciar corretamente, a API sera aberta localmente na porta:

http://localhost:18388/

4. Gerar o Token no Postman

No Postman, crie uma requisição para gerar o token:

• Método: POST
• URL:

http://localhost:18388/token

Na aba Body, selecione x-www-form-urlencoded e informe os seguintes campos:

Depois clique em Send.

Se a chamada estiver correta, o retorno da API exibira o token de acesso.

5. Validar o Endpoint Marcação

Com o token gerado, valide o endpoint:

• Método: GET
• URL de exemplo:

http://localhost:18388//api/Marcacao?CPF=401.236.108-26&Mes=7&Ano=2026&Matricula=392144

Os parâmetros utilizados na URL são:

Na aba Authorization do Postman, utilize o token gerado anteriormente como Bearer Token.

6. Resultado Esperado

Ao enviar a requisição, a API deve retornar as informações referentes ao empregado, CPF, matrícula e data informados.

Caso a chamada retorne erro:

• Confirme se o projeto cwkWebAPIPontoWeb está rodando.
• Confirme se a porta local é 18388.
• Gere um novo token no endpoint /token.
• Verifique se os parâmetros CPF, Matricula e Data foram informados corretamente.