Przejdź do treści
AchaduDevelopers
Achadu/Developers/Koncepcje

Przewidywalny model całej operacji.

Przed wywołaniem punktów końcowych należy dowiedzieć się, w jaki sposób konto, zasoby, stany i zdarzenia są ze sobą powiązane. Ten sam model dotyczy REST, MCP i CLI.

Zasoby i tożsamość

Każdy klucz należy do jednego konta. Identyfikatory są nieprzejrzyste, stabilne i mają sens tylko w ramach tego konta; nigdy nie czerp znaczenia z przedrostka lub rozmiaru.

Konto

Źródło ofert, odbiorców, sklepu, integracji i przychodów.

Oferta

Produkt znaleziony lub stworzony przed jakąkolwiek publikacją.

Publikacja

Możliwa do prześledzenia próba dystrybucji oferty do miejsca docelowego.

Kontakt i rozmowa

Historia osoby i usług w skrzynce odbiorczej DU.

Podróż

Przepływ umożliwiający wersjonowanie, który reaguje na zdarzenia i wykonuje akcje.

Odbiór

Możliwość uzgodnienia dowodów prowizji i płatności.

Stany i przejścia

Operacje asynchroniczne zwracają bieżący stan, a nie obietnicę natychmiastowego zakończenia. Postępuj zgodnie z osią czasu lub zasubskrybuj odpowiednie wydarzenie.

1
Utworzono

Odwołanie zostało przyjęte i nadano numer identyfikacyjny.

2
W przetwarzaniu

Dedykowana kolejka wykonuje zadanie poza żądaniem HTTP.

3
Ukończono lub nie udało się

Wynik, próby i błędy są dostępne do kontroli.

Brakujące daty, wartości i pola

identyfikatoryNieprzezroczyste ciągi znaków, takie jak off_..., pub_... i conv_...
DatyISO 8601 w UTC, na przykład 2026-08-31T18:20:00.000Z
PieniądzeLiczba dziesiętna z walutą w ISO 4217
Pola opcjonalneMożna je pominąć; null oznacza znaną nieobecność
Wartości logiczneUżywaj prawdy lub fałszu, nigdy 0, 1 ani tekstu

Spójność i skutki uboczne

Natychmiastowe odczyty

CRUD i konfiguracja odzwierciedlają rejestrację przypisaną do tego samego konta.

Przetwarzanie asynchroniczne

Po udzieleniu odpowiedzi można kontynuować publikowanie, importowanie, synchronizowanie i wykonywanie.

Zdarzenia po zatwierdzeniu

Element webhook jest umieszczany w kolejce dopiero po utrwaleniu zmiany.

Wyraźne usunięcie

Destrukcyjne punkty końcowe są zaznaczone w odnośniku i nigdy nie są wywnioskowane przez aktualizację.