Un modello prevedibile per l'intera operazione.
Prima di chiamare gli endpoint, comprendere la relazione tra account, risorse, stati ed eventi. Lo stesso modello si applica a REST, MCP e CLI.
Risorse e identità
Ogni chiave appartiene a un singolo account. Gli ID sono opachi, stabili e hanno senso solo all'interno di quell'account; non ricavare mai il significato dal prefisso o dalla dimensione.
La radice di offerte, audience, store, integrazioni e revenue.
Il prodotto trovato o creato prima di qualsiasi pubblicazione.
Un tentativo tracciabile di distribuire un'offerta a una destinazione.
La cronologia della persona e del servizio nella casella di posta DU.
Il flusso versionebile che reagisce agli eventi ed esegue azioni.
Prova riconciliabile di commissione e pagamento.
Stati e transizioni
Le operazioni asincrone restituiscono lo stato corrente e non la promessa di completamento immediato. Segui la timeline o iscriviti all'evento corrispondente.
Il ricorso è stato accolto e gli è stato assegnato un documento d'identità.
La coda dedicata esegue l'attività al di fuori della richiesta HTTP.
Il risultato, le prove e gli errori sono disponibili per la verifica.
Date, valori e campi mancanti
IDStringhe opache come off_..., pub_... e conv_...DateISO 8601 in UTC, ad esempio 2026-08-31T18:20:00.000ZSoldiNumero decimale accompagnato dalla valuta nella norma ISO 4217Campi facoltativiPossono essere omessi; null rappresenta l'assenza notaBooleaniUtilizza vero o falso, mai 0, 1 o testoCoerenza ed effetti collaterali
CRUD e la configurazione riflettono la registrazione impegnata nello stesso account.
La pubblicazione, l'importazione, la sincronizzazione e l'esecuzione possono continuare dopo la risposta.
Il webhook viene accodato solo dopo che la modifica è stata mantenuta.
Gli endpoint distruttivi sono contrassegnati nel riferimento e non vengono mai dedotti da un aggiornamento.