Integração via API

Integre seus anúncios de veículos diretamente na plataforma Compare Compre Carro de forma automatizada.

Como funciona?

  • 1. Solicite acesso à API através da sua conta. Um administrador habilitará sua chave de acesso.
  • 2. Acesse Minha API na sua área de conta para gerar e gerenciar seu token.
  • 3. Use o token para autenticar suas requisições via Authorization: Bearer SEU_TOKEN.
  • 4. Envie seus anúncios via POST /api/v1/partner/advertisements. Consulte a documentação para ver todos os campos e exemplos.
  • 5. Envie as fotos dos veículos de três formas: upload multipart (photos[]), URLs remotas (photo_urls[] — a plataforma baixa e armazena) ou depois via POST /advertisements/{id}/photos.

Fotos dos anúncios

A API aceita várias imagens por requisição (até 20 por envio e 30 por anúncio). Formatos suportados: JPEG, PNG, GIF e WebP, com até 10 MB cada.

Exemplo — várias fotos por URL (recomendado para ERP/CDN):

curl -X POST "https://comparecomprecarro.com.br/api/v1/sandbox/partner/advertisements/123/photos" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"photo_urls":["https://cdn.exemplo.com/f1.jpg","https://cdn.exemplo.com/f2.jpg"]}'

Para remover uma foto: DELETE /advertisements/{id}/photos/{photoId}. Detalhes completos na documentação da API.

Ambiente Sandbox

Seu token é criado inicialmente em modo Sandbox: os anúncios enviados ficam em ambiente de testes e não aparecem no site. Após validar sua integração, entre em contato para ativar o modo produção.