Integracja API
Integracja API generuje klucze i nagłówki potrzebne do połączenia własnej witryny, aplikacji lub narzędzia no-code z Bitee. W jednym miejscu masz adres API, identyfikator firmy, sekrety i dokumentację Swagger.
Partnerskie API pozwala budować własne witryny i aplikacje na danych Bitee: pobierać katalog, wyliczać koszyk, składać zamówienia. Bez edycji plików .env: wszystkie wartości kopiujesz z tego ekranu.
Klucze i nagłówki HTTP#
Każda wartość ma ikony pokazania, ukrycia i kopiowania, a sekrety dodatkowo odświeżania.
| Wartość | Nagłówek | Znaczenie |
|---|---|---|
| Adres API | (API Base URL) | Bazowy adres partnerskiego API Bitee |
| Identyfikator firmy | X-Company-Id | Identyfikator firmy (tenanta), wymagany przy każdym wywołaniu |
| Sekret wewnętrzny (BFF) | X-Internal-Secret | Używaj wyłącznie po stronie serwera (BFF, backend, no-code z serwerem pośredniczącym). Nigdy w kodzie przeglądarki |
| Sekret kanału zamówień | X-Api-Secret | Wymagany przy składaniu zamówień z zewnętrznego UI |
| Identyfikator kanału zamówień | X-Order-Type | Mapuje źródło zamówienia na skonfigurowany kanał API |
Status i dokumentacja#
Panel Status integracji pokazuje, czy konfiguracja jest Gotowa, oraz identyfikator firmy. Przycisk Uzupełnij brakujące klucze tworzy brakujące sekrety i kanał zamówień API. Panel Dokumentacja API prowadzi do Swagger UI (testowanie endpointów) i ReDoc (czytelna referencja). W Swaggerze użyj przycisku Authorize z nagłówkami wygenerowanymi na tym ekranie.
Sekcja Gotowe snippety pokazuje po wygenerowaniu kluczy gotowe przykłady kodu do wklejenia.
Kanał zamówień API#
Zamówienie złożone przez API musi pochodzić z kanału, który dopuszcza jego źródło. Kanał Sklep internetowy (typ API zewnętrzne) tworzy się razem z kluczami i przyjmuje źródła public_storefront, external_api oraz własny identyfikator. Zob. Kanały zamówień.
Skopiuj z ekranu adres, identyfikator firmy i sekrety, trzymaj sekrety po stronie serwera i testuj w Swaggerze. Odświeżenie sekretu natychmiast unieważnia stary.