Skip to main content
Wszystko, czego integracja sprzedawcy potrzebuje, by katalog ofert był aktualny: utworzyć ofertę, uzupełnić stan, wycofać ją z publikacji, zarchiwizować. Każda kategoria ma własne ścieżki — /v1/offers/accounts, /v1/offers/currency i tak dalej — z własnymi polami. Integrujesz się z kategoriami, w których sprzedajesz, a kategoria dodana do platformy później nie zmienia niczego w Twoich. To jest publiczna część API. Własne ekrany panelu sprzedawcy — wypłaty, spory, ustawienia konta — do niej nie należą i klucz API do nich nie sięga. Oferta to jedno ogłoszenie na marketplace. API nazywa je offers, podobnie jak cały tekst poniżej.

​
Bazowy URL

Tylko HTTPS, a każda ścieżka ma wersję: /v1/....

​
Pierwsze zapytanie

1

Utwórz klucz

W panelu sprzedawcy przejdź do Sprzedawca → Klucze API i utwórz klucz. Jest pokazywany tylko raz — skopiuj go od razu, później nie da się go odczytać.
2

Wyślij go

Klucz trafia do nagłówka Authorization każdego zapytania. Nie trzeba go na nic wymieniać.
3

Sprawdź pola kategorii

To, co przyjmuje wywołanie tworzące ofertę w danej kategorii, opisuje jej własna strona referencyjna — oferta konta ma cenę i zdjęcia, oferta waluty ma produkt i stan. Od gry zależą attributes, a endpoint schematu je zwraca: pola, ich typy i to, które są wymagane.
Ta ścieżka przyjmuje slug gry. Pozostałe ścieżki katalogu wskazują grę przez id zwracane przez GET /v1/offers/games — slug zwraca tam 400.Odczyty katalogu są publiczne — możesz je przeglądać, zanim będziesz mieć klucz.

​
Statusy

Nowa oferta to draft: Twoja i niewidoczna dla nikogo innego. publish zmienia ją w active i od tej chwili kupujący mogą ją kupić — nic jej wcześniej nie sprawdza. Publikacja oferty, w której nie ma nic do sprzedania, jest odrzucana z 409: najpierw dodaj stan. Edycja nie zmienia statusu — active pozostaje na żywo, draft pozostaje szkicem. unpublish przenosi ofertę active z powrotem do draft. archived to koniec drogi: DELETE na stałe wycofuje ofertę i pozostawia ją do odczytu dla Ciebie. sold wynika z zamówień, nie z wywołań: ostatnia jednostka trafiła do zamkniętego zamówienia. Oferta, której cały stan jest w otwartych zamówieniach, pozostaje active, a anulowane zamówienie zwraca stan. Moderacja może cofnąć aktywną ofertę jako changes_requested: znika ona z marketplace, a moderation_reason_code z moderation_note mówią, co poprawić. Twój następny PATCH zmienia ją w draft; wykonaj publish, gdy będzie poprawiona. Oferta, którą moderacja usuwa za rażące złamanie zasad, zostaje usunięta: każde wywołanie na niej zwraca 404.

​
Ceny

Każda cena w tym API to liczba całkowita w centach amerykańskich. price: 4990 to 49,90 USD. Nie ma kwot ułamkowych, a USD jest jedyną walutą.

​
Co dalej

Uwierzytelnianie

Klucze, listy dozwolonych adresów, limity zapytań i znaczenie błędów.

Dokumentacja API

Wszystkie endpointy, z playgroundem do wysyłania prawdziwych zapytań.