Pular para o conteúdo principal

Verificar elegibilidade

📌 Endpoint

GET /api/v1/beneficiario/{{cpfBeneficiario}}/proposta/verificar-elegibilidade

🌐 URLs dos Ambientes

🔹 Homologação

https://integracao.hml.cloud.medsenior.com.br/api/v1/beneficiario/{{cpfBeneficiario}}/proposta/verificar-elegibilidade

🔹 Produção

https://integracao.medsenior.com.br/api/v1/beneficiario/{{cpfBeneficiario}}/proposta/verificar-elegibilidade

🔐 Autenticação

Este endpoint requer um token de autorização.

Authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO

🔽 Cabeçalhos

NomeValor
acceptapplication/json
content-typeapplication/json

🔽 Parâmetros de Entrada

NomeTipoObrigatórioDescrição
cpfstringSimCPF do pré-beneficiário
  • Exemplo de chamada
GET /api/v1/beneficiario/12345678901/proposta/verificar-elegibilidade

🔄 Exemplo de Requisição

🔹 Ambiente de homologação

curl -X 'GET' \
'https://integracao.hml.cloud.medsenior.com.br/api/v1/beneficiario/12345678901/proposta/verificar-elegibilidade' \
-H 'accept: application/json' \
-H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
-H 'content-type: application/json'

🔹 Ambiente de produção

curl -X 'GET' \
'https://integracao.medsenior.com.br/api/v1/beneficiario/12345678901/proposta/verificar-elegibilidade' \
-H 'accept: application/json' \
-H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
-H 'content-type: application/json'

✅ Resposta de Sucesso

  • Status Code: 200 OK
  • Exemplo de Resposta:
{
"elegivel": true
}

ou

{
"elegivel": false,
"motivo": "Proposta ativa com este CPF no ERP"
}

❌ Códigos de Erro

Status CodeSignificadoDescrição
400Bad RequestParâmetros inválidos ou ausentes.
401UnauthorizedFalha na autenticação do token.
403ForbiddenUsuário sem as roles necessárias.
500Server ErrorErro interno ao verificar a elegibilidade.