Guia
Primeira Integração em 10 Minutos
Trilha rápida para sair do zero até criar o primeiro anúncio em rascunho com autenticação e oficial.
Atualizado em 2026-04-10
1. Provisione o Service Client
- Crie o client no Auth com quando a integração rodar no browser.
- Inclua os escopos necessários (openid/profile/email).
- Inclua quando o fluxo puder rodar sem Origin válida.
- Se precisar habilitação operacional de scope, envie solicitação no formulário oficial de parceiros.
2. Faça login via OIDC (PKCE)
- Leia .
- Faça a autorização ().
- Troque o code no e obtenha access_token.
3. Consulte catálogo antes de montar payload
Listar tipos de anúncios ativos.
Listar categorias por kind.
Validar cadeia marca > modelo > versão > ano.
Consultar opcionais (vehicle-options/add-info).
4. Crie anúncio em rascunho
Envie isDraft=true no primeiro envio. Isso permite construir o anúncio por etapas sem falhar por falta de mídia ou campos de publicação.
- POST
- Use idempotente desde o primeiro create.
- Preencha o bloco técnico correto por tipo de anúncio (vehicle, implement, agriculturalMachine, civilMachine, utilityDetails).
5. Envie mídia e publique
- /vídeo.
- Reordene e marque principal.
- Atualize anúncio com isDraft=false quando regras de publicação estiverem atendidas.
6. Ative observabilidade mínima
Enviar X-Correlation-Id em toda chamada.
Tratar 401/403/422 com mensagens amigáveis para o operador.
Registrar request/response por correlation id para suporte.
Rota curta recomendada
Com esta sequência, o time parceiro normalmente fecha a primeira publicação operacional sem dependências ocultas.