Przejdź do głównej zawartości

Szybki start

W panelu marki otwórz Oferty → Utwórz ofertę, w bloku „Jak płacisz twórcom?” wybierz RevShare, wypełnij formularz i wyślij go do moderacji. Budżet przechodzi z Twojego salda do oferty. Wszystkie pola opisuje strona Oferta RevShare.

Gdy oferta zostanie zatwierdzona, otwórz stronę oferty i utwórz klucz w bloku Klucz API. Klucz jest pokazywany tylko raz: skopiuj go do swojego magazynu sekretów. Każda oferta ma własny klucz.

Okno terminala
export SULY_KEY='suly_…'
Okno terminala
curl -s https://suly.gg/api/partner/v1/program \
-H "Authorization: Bearer $SULY_KEY"

Dostajesz ofertę z jej statusem, budżetem i aktualną prowizją.

Odczytaj twórców, którzy czekają na kod:

Okno terminala
curl -s "https://suly.gg/api/partner/v1/participants?status=pending" \
-H "Authorization: Bearer $SULY_KEY"

Dla każdego utwórz w swoim systemie kod polecający i link, a potem je prześlij:

Okno terminala
curl -s https://suly.gg/api/partner/v1/participants/$ID/code \
-H "Authorization: Bearer $SULY_KEY" \
-H 'Content-Type: application/json' \
-d '{"code":"ANDRY","link":"https://partner.example/r/ANDRY"}'

Twórca od razu widzi kod i link.

Gdy Twój system wyliczy, ile zarobił twórca, prześlij naliczenie z własnym numerem operacji:

Okno terminala
curl -s https://suly.gg/api/partner/v1/accruals \
-H "Authorization: Bearer $SULY_KEY" \
-H 'Content-Type: application/json' \
-d '{"participantId":"'$ID'","amount":"125.40","externalId":"2026-10-ANDRY","comment":"October 2026"}'

Ponowne wysłanie tego samego żądania z tym samym externalId niczego nie opłaca dwa razy, więc można je bezpiecznie powtórzyć po przekroczeniu limitu czasu.

  1. Co 5–15 minut: odczytuj uczestników ze statusem pending i wydawaj każdemu kod i link (albo odmawiaj).
  2. Według swojego harmonogramu wypłat: sprawdź budżet przez GET /program, a potem prześlij po jednym naliczeniu na twórcę.
  3. Codziennie i po każdej wypłacie: przesyłaj każdemu twórcy notatkę z tym, czego nie widzi w suly.gg.
  4. Uzgadnianie: dopasuj GET /accruals do własnych wypłat po externalId.