KL API Externa
/api/ext/v1
Visao geralAutenticacaoEndpointsErros

Documentacao REST

API externa KL Rent a Car

Consulte grupos de veiculos ativos e boletos pendentes por CPF em uma interface versionada, padronizada e pronta para integracoes de terceiros.

Base de consumo
https://externo.api.klrentacar.com.br/api/ext/v1
RESTJSONCPFBearer

Base URL

https://externo.api.klrentacar.com.br

Formato

JSON

Versao

/api/ext/v1

Autenticacao

Primeiro autentique com login e senha cadastrados em usuarios_externos. A resposta retorna um token JWT que deve ser enviado no header Authorization como Bearer token.

Login

curl -X POST "https://externo.api.klrentacar.com.br/api/ext/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "login": "teste",
    "senha": "teste"
  }'

Resposta

{
  "success": true,
  "message": "Login realizado com sucesso.",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs...",
    "tokenType": "Bearer",
    "expiresIn": 86400,
    "usuario": {
      "id": 1,
      "nome": "Teste",
      "login": "teste"
    }
  }
}

Endpoints disponiveis

Todos retornam o mesmo envelope de resposta e usam HTTP status adequado.

GET/api/ext/v1/grupos

Grupos de veiculos ativos

Lista os grupos ativos usados pelo sistema KL Rent a Car, ordenados pelo nome do grupo.

Parametros

Nenhum

Este endpoint nao exige parametros.

Exemplo

curl -X GET "https://externo.api.klrentacar.com.br/api/ext/v1/grupos" \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta

{
  "success": true,
  "message": "Consulta realizada com sucesso.",
  "data": [
    {
      "id": 1,
      "nome": "Economico",
      "sigla": "A"
    }
  ]
}
GET/api/ext/v1/boletos

Todos os boletos pendentes

Busca o cliente por CPF e retorna todos os boletos pendentes, do mais recente para o mais antigo.

Parametros

cpf

CPF do cliente, com ou sem mascara.

Exemplo

curl -X GET "https://externo.api.klrentacar.com.br/api/ext/v1/boletos?cpf=12345678900" \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta

{
  "success": true,
  "message": "Consulta realizada com sucesso.",
  "data": [
    {
      "id": 1520,
      "numero": "0001520",
      "valor": 520,
      "vencimento": "2026-07-15",
      "status": "PENDENTE"
    }
  ]
}
GET/api/ext/v1/boletos/ultimo

Ultimo boleto pendente

Busca o cliente por CPF e retorna somente o boleto pendente mais recente. Quando nao existir, retorna null.

Parametros

cpf

CPF do cliente, com ou sem mascara.

Exemplo

curl -X GET "https://externo.api.klrentacar.com.br/api/ext/v1/boletos/ultimo?cpf=12345678900" \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta

{
  "success": true,
  "message": "Consulta realizada com sucesso.",
  "data": {
    "id": 1520,
    "numero": "0001520",
    "valor": 520,
    "vencimento": "2026-07-15",
    "status": "PENDENTE"
  }
}
GET/api/ext/v1/best/carros-a-venda

Carros a venda BestCar

Lista os veiculos disponiveis para venda no banco BestCar, com marca, modelo, valor, fotos e descricao.

Parametros

Nenhum

Este endpoint nao exige parametros.

Exemplo

curl -X GET "https://externo.api.klrentacar.com.br/api/ext/v1/best/carros-a-venda" \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta

{
  "success": true,
  "message": "Carros à venda encontrados com sucesso.",
  "data": [
    {
      "id": 1,
      "marca": "Toyota",
      "modelo": "Corolla",
      "ano": "2022",
      "placa": "ABC1D23",
      "valor_venda": 95000.00,
      "status": "A VENDA",
      "fotos": [],
      "descricao": "Veículo disponível para venda."
    }
  ]
}

Padrao de erros

Toda falha retorna o mesmo formato, com codigo HTTP adequado.

{
  "success": false,
  "message": "Cliente nao encontrado.",
  "data": null
}
200Consulta realizada com sucesso.
400CPF invalido ou parametro obrigatorio ausente.
401Login, senha ou token Bearer invalidos.
404Cliente nao encontrado.
500Erro interno nao esperado.