Skip to main content
AceDataCloud obecnie nie posiada zagregowanego endpointu /api/v1/distribution/. Dane dotyczące nagród za polecenia składają się z czterech grup interfejsów: statusu, historii, poziomów i wymiany; wywołuj je zgodnie z wymaganym zasobem, unikając polegania na nieistniejącej zagregowanej odpowiedzi.

Przygotowanie

  1. Utwórz i zapisz Account Token w konsoli Account Token.
  2. Użyj GET /api/v1/platform-tokens/me/, aby uzyskać UUID bieżącego konta.

Dostępne interfejsy

Przykłady żądań tylko do odczytu

Forma odpowiedzi zweryfikowana w środowisku produkcyjnym to:
  • lista status, history, level, redemption: {count, items};
  • redemption preview: pojedynczy obiekt zawierający pola eligible, reason, reward_amount, credit_amount, credits_per_usd, currency, package, global_application i inne.
Elementy statusu i historii będą rozszerzane wraz z kontrolą ryzyka poleceń, rekompensatami i regułami nagród; klient powinien odczytywać je w razie potrzeby i nie polegać na zagregowanych polach, takich jak referral_url, recent_orders, withdrawable_balance, które nie są zwracane przez interfejs w starszej dokumentacji.
Inicjalizacja i wymiana są operacjami zapisu. Skrypty produkcyjne powinny najpierw wywołać interfejsy tylko do odczytu, aby sprawdzić status, oraz utrwalać unikalny idempotency_key dla żądań wymiany; nie należy automatycznie ponawiać wymian o nieznanym wyniku.

Powiązane strony

Zamówienia z narzutem cenowym subwitryny

W przypadku zamówień subwitryn objętych nowymi zasadami prowizja za polecenie jest obliczana na podstawie ceny bazowej po rabacie, a cała różnica wynikająca z narzutu po rabacie przypada właścicielowi witryny w momencie utworzenia zamówienia. Dwie części nagrody dla tego samego beneficjenta są łączone w pierwotnym rekordzie dystrybucji, a historia dystrybucji pokaże ich skład; zamówienia bez narzutu oraz zamówienia historyczne zachowują pierwotne zasady. Na przykład, jeśli cena bazowa wynosi 100, a po narzucie 120, właściciel witryny jest jednocześnie jedyną osobą polecającą, a proporcja wynosi 10%, nagroda za to zamówienie wynosi 10 + 20 = 30. Gdy właściciel witryny i osoba polecająca nie są tą samą osobą, obie osoby otrzymują odpowiednio należne im nagrody. Rozliczenie gotówkowe nadal jest realizowane ręcznie przez platformę. Platforma ręcznie dokonuje płatności po pomniejszeniu dostępnej kwoty tej transakcji na pierwotnym koncie nagród; część już wymieniona na punkty nie może zostać ponownie wypłacona w gotówce. Jeśli po zwrocie pojawi się niedobór nagród, zostanie on najpierw potrącony z kolejnych nagród.