API de integrações
Contrato para sistemas de gestão publicarem e manterem o estoque de uma revenda na iRoddas. O sistema de origem envia os anúncios. A iRoddas publica, atualiza e remove os veículos conforme o status informado. O contato com o comprador permanece no WhatsApp do anúncio.
Escopo
Esta versão contempla o estoque de revendas. A revenda deve possuir conta e perfil ativos na iRoddas. Anúncios de pessoa física são criados diretamente no site e não fazem parte deste contrato. A criação de revendas pela API está prevista para uma versão posterior.
Autenticação
A autenticação é feita por chave de API exclusiva da revenda. O administrador da conta gera a chave em Integrações e a informa ao sistema de gestão. A chave é exibida uma única vez. Cada revenda pode manter até cinco chaves ativas. A revogação interrompe apenas o acesso da credencial revogada.
As requisições devem enviar Authorization: Bearer ird_live_… em produção. No ambiente de homologação, o prefixo é ird_test_. O limite é de 60 requisições por minuto por chave.
Operações
- Criar ou atualizar um veículo a partir do identificador do sistema de origem.
- Pausar, reativar ou marcar o anúncio como vendido.
- Remover um anúncio publicado por esta API. Anúncios criados no site não são afetados.
- Consultar um anúncio ou a lista da revenda, incluindo o estado de processamento das fotos.
- Importar fotos por URL HTTPS nos formatos JPEG, PNG ou WebP, com até 10 MB. A primeira URL é a capa.
A placa completa não é armazenada. Apenas o último caractere é registrado. Vídeo, destaque, financiamento e retorno de leads não estão disponíveis nesta versão. Campos não suportados são ignorados e informados em warnings, sem impedir a publicação do anúncio.
Ambientes
- Produção: https://api.iroddas.com.br/api/v1
- Homologação: https://api-staging.iroddas.com.br/api/v1
O contrato é o mesmo nos dois ambientes. Cada chave é válida apenas no ambiente em que foi emitida.
Referência
A especificação OpenAPI descreve os campos, os exemplos de requisição e os códigos de erro.
curl -X PUT 'https://api.iroddas.com.br/api/v1/integrations/stock/SV-1001' \
-H 'Authorization: Bearer ird_live_SUA_CHAVE' \
-H 'Content-Type: application/json' \
-d '{
"brand": "Fiat",
"model": "Argo",
"category": "car",
"year_manufacture": 2022,
"year_model": 2023,
"mileage": 32000,
"fuel": "flex",
"transmission": "manual",
"price": 68900,
"city": "Rondonópolis",
"state": "MT"
}'