Deweloperzy

Publiczne API ControlResell

Zautomatyzuj swoją działalność za pomocą własnych skryptów i narzędzi: odczytuj konta, artykuły i konwersacje za pomocą klucza API.

Publiczne API jest w trakcie wdrażania. Jest zarezerwowane dla subskrypcji, które je obejmują, i udostępniane stopniowo: strona zarządzania kluczami nie jest jeszcze widoczna na każdym koncie. Bez dostępu API zwraca błąd 402.

Wygeneruj klucz API

Klucze tworzy się w aplikacji, w ramach Twojej sesji. Klucz nie może tworzyć, wyświetlać ani unieważniać innych kluczy.

  1. Zaloguj się do aplikacji internetowej ControlResell.
  2. Otwórz Ustawienia, a następnie Dla deweloperów.
  3. Utwórz klucz: nadaj mu nazwę, zaznacz co najmniej jeden zakres i, jeśli chcesz, datę wygaśnięcia (maksymalnie 5 lat).
  4. Skopiuj sekret od razu: jest wyświetlany tylko raz.

Zarządzaj moimi kluczami API

Sekret zaczyna się od cr_live_. Traktuj go jak hasło: ControlResell przechowuje tylko jego skrót i nie może go pokazać ponownie. W razie wątpliwości unieważnij klucz i utwórz nowy.

Przesyłaj klucz w nagłówku Authorization każdego wywołania. Przykład odczytu Twojego profilu:

curl https://api.controlresell.com/api/public/v1/me \
  -H "Authorization: Bearer cr_live_..."

Możesz mieć najwyżej 10 aktywnych kluczy, każdy do unieważnienia w dowolnej chwili.

Dostępne zakresy

  • accounts:read – Odczyt kont marketplace
  • items:read – Odczyt artykułów i ich ogłoszeń
  • items:write – Zapis artykułów
  • orders:read – Odczyt zamówień
  • conversations:read – Odczyt konwersacji
  • conversations:write – Zapis konwersacji

Dokumentacja API

Interaktywna dokumentacja (Swagger) i specyfikacja OpenAPI są publiczne i generowane z produkcyjnego API.

API jest wersjonowane (/api/public/v1). Wersja v1 zmienia się wyłącznie przez dodawanie; przy zmianie niezgodnej otwierana jest v2, a v1 pozostaje dostępna co najmniej dwanaście miesięcy od ogłoszenia.

Oficjalne SDK i CLI

SDK generowane ze specyfikacji oraz CLI, open source na GitHubie.

Pakiety nie zostały jeszcze opublikowane: wkrótce w npm, PyPI i Maven Central. Do tego czasu kod źródłowy jest dostępny na GitHubie.