> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Sprawdzanie informacji o nagrodach za polecenia AceDataCloud

> Platform API guide - Ace Data Cloud

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](https://platform.acedata.cloud/console/platform-tokens).
2. Użyj `GET /api/v1/platform-tokens/me/`, aby uzyskać UUID bieżącego konta.

```shell theme={null}
export PLATFORM_TOKEN='你的账户令牌'
export USER_ID='你的账户 UUID'
```

## Dostępne interfejsy

| Metoda | URL | Zastosowanie |
| - | - | - |
| `GET` | `/api/v1/distribution-statuses/?user_id=${USER_ID}` | Łączna kwota poleceń, nagrody i poziom bieżącego konta |
| `POST` | `/api/v1/distribution-statuses/initialize/` | Pierwsza inicjalizacja lub odświeżenie poziomu bieżącego konta; zapisuje dane |
| `GET` | `/api/v1/distribution-histories/?user_id=${USER_ID}` | Historia nagród za polecenia |
| `GET` | `/api/v1/distribution-levels/` | Reguły poziomów i proporcji |
| `GET` | `/api/v1/distribution-redemptions/preview/` | Podgląd aktualnie dostępnych do wymiany nagród; opcjonalne `amount` |
| `GET` | `/api/v1/distribution-redemptions/` | Ukończone rekordy wymian |
| `POST` | `/api/v1/distribution-redemptions/redeem/` | Potwierdzenie wymiany; wymaga `idempotency_key`, tworzy nieodwracalną wymianę |

## Przykłady żądań tylko do odczytu

```shell theme={null}
curl --get 'https://platform.acedata.cloud/api/v1/distribution-statuses/' \
  --data-urlencode "user_id=${USER_ID}" \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"

curl --get 'https://platform.acedata.cloud/api/v1/distribution-histories/' \
  --data-urlencode "user_id=${USER_ID}" \
  --data-urlencode 'limit=100' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"

curl 'https://platform.acedata.cloud/api/v1/distribution-levels/' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"

curl 'https://platform.acedata.cloud/api/v1/distribution-redemptions/preview/' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"
```

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

* [Uzyskiwanie listy zamówień](https://platform.acedata.cloud/documents/platform-order-list)
* [Zarządzanie tokenami konta](https://platform.acedata.cloud/documents/platform-token)

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.