Consulta chave de contrato de plano
Consulta código do cartão de um contrato de plano, que é uma chave, para obter o código do plano contrato e o código do plano. A chave (número do cartão) é passado como parâmetro na URL do serviço.
Como consulta opcional, pode-se informar o CPF do credenciado como parâmetro QUERY STRING, desta forma, iremos validar se o documento (CFP/CNPJ) informado pertence à chave informada. Caso não pertença, iremos retornar chave não encontrada.
Em ambiente de desenvolvimento, todas chaves, com exceção daqueles iniciados pelo dígito “9”, serão encontrados e possuirão um plano_contrato_id e plano_id gerado aleatoriamente. As requisições com chaves iniciadas pelo dígito “9” retornarão código de erro 404 (not found).
GET api/contratos_planos_chaves/<chave>
HEADERS
CHAVE |
VALOR |
DESCRIÇÃO |
OBRIGATÓRIO |
Accept |
application/vnd.linkc.com.br; version=1 | Versão da API. | SIM |
Authorization |
Bearer <TOKEN> |
Token obtido na autenticação |
SIM |
Content-Type |
application/json |
Tipo de conteúdo do request |
SIM |
PARÂMETRO QUERY STRING
CHAVE |
DESCRIÇÃO |
OBRIGATÓRIO |
cpf |
CPF do credenciado |
NÃO |
RETORNO EM CASO DE SUCESSO (200 – OK)
CHAVE |
DESCRIÇÃO |
plano_contrato_id |
Código do contrato de plano. |
cartao_id |
Código do cartão. |
plano_id |
Código do plano. |
EXEMPLO DE RETORNO EM CASO DE SUCESSO (200 – OK)
{
"plano_contrato_chave": {
"chave": "1234567890",
"contrato_plano": {
"id": "4413b7e9-82ec-49ec-ab9c-cef8642bdaa0",
"plano_id": "e1c0e701-56ed-49a4-af8f-001131ff9bad"
}
}
}
OUTROS RETORNOS
CÓDIGO HTTP |
DESCRIÇÃO |
400 |
Caso não seja recebido o parâmetro <cartao_id>. |
401 |
Caso as credenciais sejam inválidas. |
422 |
Caso o cartão não seja encontrado. |