Przegląd API

API Zanfii pozwala programistycznie odczytywać i zarządzać wszystkim, co znajduje się w Twoim workspace — produktami, ofertami i cenami, treścią kursów, społecznościami, stronami, klientami, zamówieniami i statystykami. Wszystko, co robi Zanfia CLI, przechodzi przez to samo API, więc każdą operację widoczną w CLI możesz wykonać zwykłym zapytaniem HTTP.

Dwie powierzchnie API

Obie używają tego samego uwierzytelniania tokenem bearer i tych samych konwencji JSON.

Twoje pierwsze zapytanie

Utwórz klucz API w panelu (zobacz Uwierzytelnianie i klucze API), a następnie:

curl "https://europe-central2-mailingr-54736.cloudfunctions.net/api-v1/products" \
  -H "Authorization: Bearer YOUR_API_KEY"

Workspace jest rozpoznawany na podstawie klucza — nigdy nie przekazujesz id workspace'u.

Konwencje

• JSON na wejściu, JSON na wyjściu. Przy zapisach wysyłaj nagłówek Content-Type: application/json.
• Błędy zwracają status spoza zakresu 2xx z ciałem JSON zawierającym maszynowo czytelny powód — na przykład 404 z { "error": "lesson-not-found" } albo 403 z kodem takim jak insufficient-scope.
• Kwoty są w jednostkach podrzędnych (minor units). 1999 oznacza 19,99 w danej walucie.
• Listy stronicują kursorami. Endpointy listujące przyjmują parametry limit i cursor i zwracają kolejny kursor razem ze stroną wyników.
• Treść to Markdown. Treści lekcji, posty i komentarze są przechowywane i zwracane jako Markdown.

Co czytać dalej

• Uwierzytelnianie i klucze API — utwórz klucz i nadaj mu właściwe uprawnienia.
• Dokumentacja endpointów — każda ścieżka ze schematami i przykładami kodu, jedna strona na zasób: Produkty, Oferty i order bumpy, Kursy i quizy, Media, Strony, Społeczności, Klienci, Zamówienia, statystyki i rabaty.
• Szybki start z CLI — ta sama funkcjonalność z poziomu terminala, bez pisania zapytań HTTP.
• Podłącz klientów AI przez MCP — daj Claude'owi, Cursorowi lub ChatGPT bezpośredni dostęp do swojego workspace'u.