chavenachave

Buscar veículos chavenachave BUSCAR VEÍCULO


Localização LOCALIZAÇÃO

- km



  • Câmbio CÂMBIO
    • Manual

      Automático

      CVT

    • Automatizado


  • Direção DIREÇÃO
    • Mecânica

      Hidráulica

      Elétrica

    • Eletro-hidráulica

      Esférica

      Cônica


  • Cor COR VEÍCULO
    • Branco

      Cinza

      Prata

    • Preto

      Vermelho

      Amarelo

    • Azul

      Bege

      Bronze

    • Dourado

      Laranja

      Marrom

    • Rosa

      Roxo

      Verde

    • Vinho

      Indefinida


  • Portas PORTAS
    • 1 porta

      2 portas

      3 portas

    • 4 portas

      5 portas



  • Opcionais OPCIONAIS
    • Airbag
      Air bag

      Alarme
      Alarme

      Ar condicionado
      A/C

      Direção Hidraulica
      Direção hidráulica

      ABS
      Freios
      ABS

      Travas elétricas
      Trava elétrica

      Vidros Elétricos
      Vidros elétricos

      Banco Motorista
      Regulagem banco

      Banco de couro Bancos de couro

      Computador de bordo
      Computador de bordo

      Desembaçador Traseiro
      Desembacador traseiro

      Rodas de liga Rodas de Liga

      Teto Solar
      Teto
      solar

      4x4
      Tração 4x4


  • Detalhes DETALHES
    • IPVA
      IPVA pago

      Financiado
      Financiado

      Licenciado
      Licenciado

      Garantia
      Garantia de fabrica

      Colecionador
      Veículo de Colecionador

      Revisões
      Todas revisões

      Documento
      Documento Ok

      Sinistro
      Veículo sinistrado

      Leilão
      Veículo de leilão

      Deficiente
      Adaptado deficientes

      Blindado
      Veículo blindado


Documentação da API - Chavenachave v1.2

Integração completa de estoque e procedência de veículos.

1. Autenticação

Envie o token no cabeçalho Authorization de todas as requisições.


Authorization: Bearer SEU_TOKEN_AQUI
Atenção: O acesso à API de integração é exclusivo para contas com o plano (Revenda) ativo. Caso sua conta não seja de revenda, as requisições retornarão erro 403 Forbidden. Para alterar seu plano para revenda entre no Menu Principal e acesse a opção Comprar Chaves.
2. Send/Envio
POST Cadastrar ou Atualizar Veículo

Utilize o campo codigo_referencia para sincronizar seu ID interno com o nosso banco de dados.

  • Endpoint: https://chavenachave.com.br/api/veiculos.php
Exemplo de Payload Completo (JSON):
{
  "codigo_referencia": "SEU_ID_REFERENCIA_DO_VEICULO",
  "codigoTipoVeiculo": "1",
  "tipo": "Carro",
  "marca": "GM - Chevrolet",
  "modelo": "TRACKER RS 1.2 Turbo 12V Flex Aut.",
  "anoFabricacao": 2024,
  "anoModelo": 2024,
  "zerokm": "N",
  "km": "24100",
  "valor": "123000.00",
  "cor": "Vermelho",
  "combustivel": "Flex",
  "cambio": "Automático",
  "direcao": "Hidráulica",
  "portas": "5",
  "placa": "ABC-1234",
  "finalPlaca": "4",
  "unicoDono": "Sim",
  "descricao": "Único dono, todas as revisões na concessionária.",
  "video": "https://youtube.com/link-do-video",
  
  "documento": 1,
  "sinistro": 0,
  "leilao": 0,
  "chaveReserva": 1,
  "manual": 1,
  "laudoCautelar": 1,

  "codigoMarca": "23",
  "codigoModelo": "10637",

  "opcionais": {
	"AirBag": 1,
	"Alarme": 1,
	"ArCondicionado": 1,
	"DirecaoHidraulica": 1,
	"FreioABS": 1,
	"TravasEletricas": 1,
	"VidrosEletricos": 1,
	"ArQuente": 1,
	"BancoMotorista": 1,
	"BancosCouro": 1,
	"ComputadorBordo": 1,
	"DesembacadorTraseiro": 1,
	"RodasLiga": 1,
	"TetoSolar": 1,
	"Tracao4x": 0,
	"IPVAPago": 1,
	"VeiculoFinanciado": 0,
	"Licenciado": 1,
	"GarantiaFabrica": 1,
	"VeiculoColecionador": 0,
	"Revisoes": 1,
	"Blindado": 0
  },
  "fotos": [
	"https://img.integrador.com.br/foto1.jpg",
	"https://img.integrador.com.br/foto2.jpg"
  ]
}
								
							
3. Deletar/Desativar
DELETE Remover Veículo (Vendido)

Para desativar um anúncio, envie o codigo_referencia via URL. Utilize o method DELETE

https://chavenachave.com.br/api/veiculos.php?codigo_referencia=SEU_ID_REFERENCIA_DO_VEICULO
4. Referência de Campos (Procedência/Status)
Campo Tipo Descrição (0 = Não / 1 = Sim)
codigoTipoVeiculo Int 1: Carro | 2: Moto | 3: Caminhão
zerokm String S para Sim | N para Não
documentoIntStatus do documento em dia
sinistroIntPossui sinistro?
leilaoIntPossui passagem por leilão?
chaveReservaIntPossui chave reserva?
manualIntPossui manual do proprietário?
laudoCautelarIntPossui laudo cautelar aprovado?
videoStringLink do YouTube ou Vimeo
5. Respostas do Servidor (HTTP Status Codes)
Código Status Descrição / Causa Provável
200 OK Sucesso O veículo foi processado, cadastrado ou atualizado com sucesso.
400 Bad Request Erro de Requisição Falta o codigo_referencia ou o JSON enviado está malformado.
401 Unauthorized Não Autorizado Token inválido, expirado ou o usuário não tem permissão de integrador.
403 Forbidden Plano Inválido O token é válido, mas o usuário não possui permissão de revenda, altere seu plano para revenda aqui.
405 Method Not Allowed Método Não Permitido Você tentou usar um método diferente de POST, GET ou DELETE.
500 Internal Error Erro no Servidor Ocorreu uma falha interna no processamento. Entre em contato com o suporte.
6. Consultar Estoque via API (Leitura)
GET Recuperar todos os veículos ativos

Este endpoint retorna todos os campos técnicos, de opcionais e de procedência cadastrados no Chavenachave.

  • Endpoint: https://chavenachave.com.br/api/veiculos.php
  • Método: GET
Estrutura do JSON de Retorno:
{
"status": "sucesso",
"total_veiculos": 1,
 "veiculos": [
	{
	"codigo_referencia": "SEU_ID_REFERENCIA_DO_VEICULO",
	"tipo": "Carro",
	"marca": "GM - Chevrolet",
	"modelo": "TRACKER RS 1.2 Turbo 12V Flex Aut.",
	"anoFabricacao": 2024,
	"anoModelo": 2024,
	"zerokm": "N",
	"km": "24100",
	"valor": "123000.00",
	"cidade": "São Bernardo do Campo",
	"estado": "SP",
	"longitude": "-46.5536333",
	"latitude": "-23.7018047",
	"cor": "Vermelho",
	"combustivel": "Flex",
	"cambio": "Automático",
	"direcao": "Hidráulica",
	"portas": "5",
	"placa": "ABC-1234",
	"finalPlaca": "4",
	"unicoDono": "Sim",
	"descricao": "Único dono, todas as revisões na concessionária.",
	"video": "https://youtube.com/link-do-video",

	"AirBag": 1,
	"Alarme": 1,
	"ArCondicionado": 1,
	"DirecaoHidraulica": 1,
	"FreioABS": 1,
	"TravasEletricas": 1,
	"VidrosEletricos": 1,
	"ArQuente": 1,
	"BancoMotorista": 1,
	"BancosCouro": 1,
	"ComputadorBordo": 1,
	"DesembacadorTraseiro": 1,
	"RodasLiga": 1,
	"TetoSolar": 1,
	"Tracao4x": 0,
	"IPVAPago": 1,
	"VeiculoFinanciado": 0,
	"Licenciado": 1,
	"GarantiaFabrica": 1,
	"VeiculoColecionador": 0,
	"Revisoes": 1,
	"Blindado": 0,
	  
	"documento": 1,
	"sinistro": 0,
	"leilao": 0,
	"chaveReserva": 1,
	"manual": 1,
	"laudoCautelar": 1,

	"codigoMarca": "23",
	"codigoModelo": "10637",
	"fotos": [
	"https://chavenachave.com.br/assets/img/products/foto1.jpg",
	"https://chavenachave.com.br/assets/img/products/foto2.jpg"
	]
  }
 ]
}
Os campos de opcionais e procedência são retornados como chaves individuais (0 ou 1) conforme a estrutura do banco de dados.
Exemplo de integração em PHP

Precisa de ajuda? Clique aqui para baixar um exemplo de integração em PHP (cURL). Ou acesse nosso Repositório no GitHub para exemplos sempre atualizados.