Um modelo previsível para toda a operação.
Antes de chamar endpoints, entenda como conta, recursos, estados e eventos se relacionam. O mesmo modelo vale para REST, MCP e CLI.
Recursos e identidade
Cada chave pertence a uma única conta. IDs são opacos, estáveis e só fazem sentido dentro dessa conta; nunca derive significado a partir do prefixo ou do tamanho.
A raiz de ofertas, audiência, loja, integrações e receita.
O produto encontrado ou criado antes de qualquer publicação.
Uma tentativa rastreável de distribuir uma oferta em um destino.
A pessoa e o histórico de atendimento no DU Inbox.
O fluxo versionável que reage a eventos e executa ações.
A evidência conciliável de comissão e pagamento.
Estados e transições
Operações assíncronas retornam o estado atual, não uma promessa de conclusão imediata. Acompanhe a linha do tempo ou assine o evento correspondente.
O recurso foi aceito e recebeu um ID.
A fila dedicada executa a tarefa fora da requisição HTTP.
O resultado, as tentativas e o erro ficam disponíveis para auditoria.
Datas, valores e campos ausentes
IDsStrings opacas como off_..., pub_... e conv_...DatasISO 8601 em UTC, por exemplo 2026-08-31T18:20:00.000ZDinheiroNúmero decimal acompanhado por currency em ISO 4217Campos opcionaisPodem ser omitidos; null representa ausência conhecidaBooleanosUse true ou false, nunca 0, 1 ou textoConsistência e efeitos colaterais
CRUD e configuração refletem a gravação confirmada na mesma conta.
Publicação, importação, sincronização e execução podem continuar após a resposta.
O webhook é enfileirado somente depois que a alteração foi persistida.
Endpoints destrutivos são marcados na referência e nunca são inferidos por uma atualização.