Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site
Painel
Achadu/Developers/Tutoriais

Fluxos completos, não chamadas isoladas.

Parta de exemplos executáveis e conecte criação, acompanhamento, eventos e recuperação de falhas como uma integração de produção.

01

Criar e publicar uma oferta

Crie a oferta pendente, revise o resultado e só então peça a publicação nos grupos autorizados. A linha do tempo registra cada tentativa.

javascript
const base = "https://achadu.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.ACHADU_API_KEY}`,
  "Content-Type": "application/json"
};

const offer = await fetch(`${base}/offers`, {
  method: "POST", headers,
  body: JSON.stringify({
    url: "https://www.amazon.com.br/dp/...",
    title: "Air fryer 5L", price: 329.90, currency: "BRL"
  })
}).then(r => r.json());

const publication = await fetch(`${base}/publications`, {
  method: "POST", headers,
  body: JSON.stringify({ offer_id: offer.data.id, group_ids: ["grp_..."] })
}).then(r => r.json());
Abrir offer_create na referência
02

Consumir webhooks sem processar duas vezes

Valide o corpo bruto, responda rapidamente e processe fora da requisição. Guarde event.id para tornar seu consumidor idempotente.

javascript
app.post("/webhooks/achadu", raw({ type: "application/json" }), (req, res) => {
  verifyAchaduSignature(req.headers, req.body);
  const event = JSON.parse(req.body.toString("utf8"));

  if (alreadyProcessed(event.id)) return res.sendStatus(200);
  enqueueByType(event.type, event.data);
  markProcessed(event.id);
  return res.sendStatus(202);
});
Ver assinatura e tentativas
03

Importar e conciliar receita

1
Importe o arquivo

Envie o CSV do programa e acompanhe commissions/imports/{id}.

2
Sincronize a fonte

Dispare commissions/sync para buscar mudanças da integração conectada.

3
Registre o recebimento

Crie o comprovante com referência externa, valor e moeda.

4
Concilie

Execute receipts/{id}/reconcile e revise diferenças explicitamente.

04

Atender e automatizar no DU Inbox

Recupere o contexto

Abra contato, notas e mensagens antes de responder.

Atribua a conversa

Direcione ao operador ou fila responsável.

Responda

Envie texto pelo canal conectado usando o mesmo histórico.

Acione uma jornada

Valide a definição, execute e acompanhe cada execução.