Un modèle prévisible pour l’ensemble de l’opération.
Avant d'appeler des points de terminaison, comprenez les relations entre le compte, les ressources, les états et les événements. Le même modèle s'applique à REST, MCP et CLI.
Ressources et identité
Chaque clé appartient à un seul compte. Les identifiants sont opaques, stables et n’ont de sens que dans ce compte ; ne tirez jamais de sens du préfixe ou de la taille.
La racine des offres, de l'audience, du magasin, des intégrations et des revenus.
Le produit trouvé ou créé avant toute publication.
Tentative traçable de distribution d'une offre vers une destination.
L’historique de la personne et du service dans DU Inbox.
Le flux versionnable qui réagit aux événements et exécute des actions.
Preuve conciliable de commission et de paiement.
États et transitions
Les opérations asynchrones renvoient l'état actuel, et non une promesse d'achèvement immédiat. Suivez la timeline ou abonnez-vous à l'événement correspondant.
L'appel a été accepté et a reçu une pièce d'identité.
La file d'attente dédiée effectue la tâche en dehors de la requête HTTP.
Le résultat, les essais et les erreurs sont disponibles pour audit.
Dates, valeurs et champs manquants
identifiantsChaînes opaques comme off_..., pub_... et conv_...DatesISO 8601 en UTC, par exemple 2026-08-31T18:20:00.000ZArgentNombre décimal accompagné de la devise en ISO 4217Champs facultatifsIls peuvent être omis ; null représente une absence connueBooléensUtilisez vrai ou faux, jamais 0, 1 ou texteCohérence et effets secondaires
CRUD et la configuration reflètent l'enregistrement effectué sur le même compte.
La publication, l'importation, la synchronisation et l'exécution peuvent continuer après la réponse.
Le webhook est mis en file d'attente uniquement une fois la modification conservée.
Les points finaux destructeurs sont marqués dans la référence et ne sont jamais déduits par une mise à jour.