Dostęp i formaty
Bazowy URL
Dział zatytułowany „Bazowy URL”https://suly.gg/api/partner/v1Każ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.
Żądania i odpowiedzi
Dział zatytułowany „Żądania i odpowiedzi”- JSON na wejściu i wyjściu. Każdy
POSTwysyłaContent-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.
Pieniądze
Dział zatytułowany „Pieniądze”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.
Stronicowanie
Dział zatytułowany „Stronicowanie”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.