Documentação da API - Chavenachave v1.2 - Chave na chave É CHAVENACHAVE.

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
`documento`	Int	Status do documento em dia
`sinistro`	Int	Possui sinistro?
`leilao`	Int	Possui passagem por leilão?
`chaveReserva`	Int	Possui chave reserva?
`manual`	Int	Possui manual do proprietário?
`laudoCautelar`	Int	Possui laudo cautelar aprovado?
`video`	String	Link 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.

Carros

Motos

Caminhões

Renault

SANDERO STEPWAY Hi-Flex 1.6 16V 5p Aut.

GM - Chevrolet

S10 Pick-Up LT 2.5 Flex 4x4 CD

Mitsubishi

Pajero TR4 2.0 Flex 16V 4X2 Aut.

Kia Motors

Picanto EX 1.1/1.0/ 1.0 Flex Aut.

GM - Chevrolet

ONIX SEDAN Plus LTZ 1.0 12V TB Flex Aut.

Carros

Motos

Caminhões

BUSCAR VEÍCULO

- km

Procurar veículo:

Documentação da API - Chavenachave v1.2

Exemplo de Payload Completo (JSON):

Estrutura do JSON de Retorno: