Validar código confirmação

🌐 URLs dos Ambientes

🔹 Homologação

https://integracao.hml.cloud.medsenior.com.br/api/v2/beneficiario/{{cpfBeneficiario}}/codigo-confirmacao/validar

🔹 Produção

https://integracao.medsenior.com.br/api/v2/beneficiario/{{cpfBeneficiario}}/codigo-confirmacao/validar

📌 Endpoint

POST /api/v2/beneficiario/{{cpfBeneficiario}}/codigo-confirmacao/validar

🔐 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
cpf	string	Sim	Cpf do beneficiário utilizado no endpoint enviar codigo
codigo	string	Sim	codigo enviado para o e-mail/celular utilizado no enpoint de enviar codigo

• Exemplo Json de Entrada

{
    "cpf": "01234567891", 
    "codigo": "ABCDEF"
}

🔄 Exemplo de Requisição

🔹 Ambiente de homologação

curl -X 'POST' \
'https://integracao.hml.cloud.medsenior.com.br/api/v2/beneficiario/{{cpfBeneficiario}}/codigo-confirmacao/validar' \
-H 'accept: application/json' \
-H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
-H 'content-type: application/json' \
-d '{
    "cpf": "01234567891", 
    "codigo": "ABCDEF"
}'

🔹 Ambiente de produção

curl -X 'POST' \
'https://integracao.medsenior.com.br/api/v2/beneficiario/{{cpfBeneficiario}}/codigo-confirmacao/validar' \
-H 'accept: application/json' \
-H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
-H 'content-type: application/json' \
-d '{
    "cpf": "01234567891", 
    "codigo": "ABCDEF"
}'

✅ Resposta de Sucesso

• Status Code: 200 OK
• Exemplo de Resposta:

{
    "data": {
        "codigoValidado": true,
        "codigoExpirado": 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 gerar o protocolo.