Validar Beneficiário
🌐 URLs dos Ambientes
🔹 Homologação
https://integracao.hml.cloud.medsenior.com.br/api/v1/beneficiario/usuario/{{cpfBeneficiario}}
🔹 Produção
https://integracao.medsenior.com.br/api/v1/beneficiario/usuario/{{cpfBeneficiario}}
📌 Endpoint
GET /api/v1/beneficiario/usuario/{{cpfBeneficiario}}
🔐 Autenticação
Este endpoint requer um token de autorização.
Authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO
🔽 Cabeçalhos
Nome | Valor |
---|---|
accept | application/json |
content-type | application/json |
🔽 Parâmetros de Entrada
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
cpfBenficiario | string | Sim | Parametro a ser enviado junto à url |
🔄 Exemplo de Requisição
🔹 Ambiente de homologação
curl -X 'GET' \
'https://integracao.hml.cloud.medsenior.com.br/api/v1/beneficiario/usuario/{{cpfBeneficiario}}' \
-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/usuario/{{cpfBeneficiario}}' \
-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:
{
"data": {
"id": "22152f1b-d7d8-4727-97e2-20602ac02d32",
"situacao": true,
"trocarSenha": false,
"username": "15917156018",
"senhaTemporaria": false
},
"isSuccess": true
}
❌ Códigos de Erro
Status Code | Significado | Descrição |
---|---|---|
400 | Bad Request | Parâmetros inválidos ou ausentes. |
401 | Unauthorized | Falha na autenticação do token. |
500 | Server Error | Erro interno ao obter o beneficiário |