Zum Inhalt springen
AchaduDevelopers
Achadu/Developers/Konzepte

Ein vorhersehbares Modell für den gesamten Betrieb.

Bevor Sie Endpunkte aufrufen, sollten Sie verstehen, wie Konten, Ressourcen, Zustände und Ereignisse miteinander in Beziehung stehen. Das gleiche Modell gilt für REST, MCP und CLI.

Ressourcen und Identität

Jeder Schlüssel gehört zu einem einzelnen Konto. IDs sind undurchsichtig, stabil und nur innerhalb dieses Kontos sinnvoll; Leiten Sie niemals eine Bedeutung aus dem Präfix oder der Größe ab.

Konto

Die Wurzel von Angeboten, Zielgruppe, Shop, Integrationen und Umsatz.

Angebot

Das Produkt wurde vor jeder Veröffentlichung gefunden oder erstellt.

Veröffentlichung

Ein nachvollziehbarer Versuch, ein Angebot an ein Ziel zu verteilen.

Kontakt und Gespräch

Der Personen- und Serviceverlauf im DU-Posteingang.

Reise

Der versionierbare Fluss, der auf Ereignisse reagiert und Aktionen ausführt.

Empfangen

Vergleichbare Provisions- und Zahlungsnachweise.

Zustände und Übergänge

Asynchrone Vorgänge geben den aktuellen Status zurück und versprechen keinen sofortigen Abschluss. Folgen Sie der Timeline oder abonnieren Sie die entsprechende Veranstaltung.

1
Erstellt

Der Einspruch wurde angenommen und mit einem Ausweis versehen.

2
In Bearbeitung

Die dedizierte Warteschlange führt die Aufgabe außerhalb der HTTP-Anfrage aus.

3
Abgeschlossen oder fehlgeschlagen

Das Ergebnis sowie Versuche und Irrtümer stehen zur Prüfung zur Verfügung.

Fehlende Daten, Werte und Felder

AusweiseUndurchsichtige Zeichenfolgen wie off_..., pub_... und conv_...
TermineISO 8601 in UTC, zum Beispiel 2026-08-31T18:20:00.000Z
GeldDezimalzahl mit Währung in ISO 4217
Optionale FelderSie können weggelassen werden; null steht für bekannte Abwesenheit
Boolesche WerteVerwenden Sie wahr oder falsch, niemals 0, 1 oder Text

Konsistenz und Nebenwirkungen

Sofortige Lesungen

CRUD und Konfiguration spiegeln die Aufzeichnung wider, die an dasselbe Konto übertragen wurde.

Asynchrone Verarbeitung

Das Veröffentlichen, Importieren, Synchronisieren und Ausführen kann nach der Antwort fortgesetzt werden.

Ereignisse nach dem Commit

Der Webhook wird erst in die Warteschlange gestellt, nachdem die Änderung beibehalten wurde.

Explizite Löschung

Zerstörerische Endpunkte werden in der Referenz markiert und nie durch ein Update abgeleitet.