Przejdź do głównej zawartości

Dostęp i formaty

https://suly.gg/api/partner/v1

Każde żądanie zawiera nagłówek:

Authorization: Bearer suly_…
  • Klucz wygląda jak suly_ i kolejne 43 znaki (łącznie 48).
  • Tworzysz go na stronie oferty w panelu marki, w bloku Klucz API, gdy oferta zostanie zatwierdzona. Każda oferta ma własny klucz.
  • Jest pokazywany tylko raz. Zastąp klucz wydaje nowy klucz, a stary od razu przestaje działać (401).
  • Trzymaj go w tajemnicy: przechowuj w zmiennej środowiskowej lub magazynie sekretów, nigdy w kodzie, logach ani przeglądarce.
  • JSON na wejściu i wyjściu. Każdy POST wysyła Content-Type: application/json.
  • Nieznane pola i nieznane parametry zapytania są odrzucane z 400 INVALID_INPUT.
  • Czas jest podawany w formacie ISO 8601 w UTC: 2026-11-03T10:00:00.000Z.

Kwota to ciąg znaków w dolarach amerykańskich z kropką i najwyżej sześcioma miejscami po niej: "12.5", "0.01". Odpowiedzi zawsze mają sześć miejsc po kropce: "12.500000". Nigdy nie wysyłaj kwot jako liczby JSON.

Listy zwracają po 50 pozycji na stronę, od najnowszych:

{ "participants": [], "total": 0, "page": 1, "pageSize": 50 }

O następną stronę poproś przez ?page=2.

Do każdej integracji wystarczą żądania wysyłane po kolei. Jeśli otrzymasz 429 lub 503, odczekaj i powtórz żądanie później.