REST API V2

Połącz Pobo ze swoim systemem przez REST API

Importuj produkty i kategorie hurtowo i pobieraj gotowe opisy produktów we wszystkich językach. Dla programistów, którzy łączą Pobo z własnym e-sklepem lub systemem informatycznym.

Otwórz dokumentację ↗ Umów połączenie
curl "https://api.pobo.space/api/v2/rest/products?is_edited=true&lang=default,sk" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Jak to działa

  1. 1

    Wygeneruj token API

    W panelu Pobo kliknij Generate API token i wysyłaj go w nagłówku Authorization.

  2. 2

    Wyślij swój katalog

    Importuj produkty, kategorie, marki i parametry w paczkach do 100 pozycji.

  3. 3

    Stwórz treści w Pobo

    Twój zespół tworzy opisy w edytorze albo zleca ich wygenerowanie AI.

  4. 4

    Pobierz gotowe treści

    Pobierz gotowy HTML we wszystkich językach i opublikuj go w swoim e-sklepie.

Zaimportuj katalog jednym zapytaniem

Wyślij do 100 produktów naraz. Wymagane są tylko id, is_visible, domyślna nazwa i URL. Pobo paruje produkty według Twojego id, więc to samo zapytanie również je aktualizuje.

Zapytanie

POST /api/v2/rest/products
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

[
  {
    "id": "PROD-123",
    "is_visible": true,
    "name": { "default": "Trekking backpack 40 l", "sk": "Trekingový batoh 40 l" },
    "url": { "default": "https://example.com/backpack-40" },
    "images": ["https://example.com/backpack-40.jpg"],
    "categories_ids": ["CAT-OUTDOOR"]
  }
]

Odpowiedź

{
  "success": true,
  "imported": 1,
  "updated": 0,
  "skipped": 0,
  "errors": []
}

API w skrócie

Bazowy URL to https://api.pobo.space. Szczegóły każdego endpointu znajdziesz w dokumentacji.

Produkty/api/v2/rest/productsGETPOSTDELETE
Kategorie/api/v2/rest/categoriesGETPOSTDELETE
Marki/api/v2/rest/brandsGETPOSTDELETE
Blogi/api/v2/rest/blogsGETPOSTDELETE
Parametry/api/v2/rest/parametersPOST
Atomowy import wielu encji/api/v2/rest/multi-importPOST

Co otrzymujesz z powrotem

content.html

Gotowy HTML

Pole content.html zawiera wyrenderowany opis gotowy do wstawienia na stronę produktu.

include=marketplace

HTML dla marketplace

Uproszczony HTML dla marketplace, które dopuszczają tylko ograniczone znaczniki.

include=nested

Ustrukturyzowany JSON

Widgety jako zagnieżdżony JSON, jeśli chcesz renderować treść samodzielnie.

include=rich_snippet

Rich snippets

Dane strukturalne dla wyszukiwarek gotowe do wstawienia na stronę.

lang=all

Siedem wersji językowych

default, cs, sk, en, de, pl i hu. Bez parametru lang otrzymasz tylko default.

last_update_time_from

Tylko to, co się zmieniło

Filtruj pozycje edytowane w Pobo i zmiany od ostatniej synchronizacji.

Zasady, które warto znać

  • Token wysyłaj w nagłówku Authorization: Bearer YOUR_API_TOKEN
  • Do 100 pozycji w jednym zapytaniu importu lub usunięcia
  • Listy są stronicowane parametrami page i per_page, maksymalnie 100 pozycji na stronę
  • Usuwanie jest miękkie, treść pozostaje w Pobo
  • Pole id to Twój własny identyfikator, według niego Pobo paruje pozycje przy kolejnym imporcie
  • Używaj API V2. V1 pozostaje tylko dla istniejących integracji i działa wyłącznie z językiem domyślnym

Najczęściej zadawane pytania

Czy jest środowisko testowe?

Założymy Ci konto testowe, abyś mógł wypróbować połączenie na własnych produktach przed uruchomieniem.

Jaka jest różnica między API V1 a V2?

V2 obsługuje wszystkie wersje językowe Twoich treści. V1 działa tylko z językiem domyślnym i pozostaje dla istniejących integracji.

Jak długo zwykle trwa połączenie?

Zwykle 2 tygodnie od podpisania umowy do uruchomienia produkcyjnego. Dokładny szacunek otrzymasz po spotkaniu, na którym omówimy zakres i Twoje wymagania.

Czy Pobo powiadamia mój system o zmianach?

Jeszcze nie automatycznie. Pobieraj treści regularnie i używaj filtra last_update_time_from, aby otrzymać tylko to, co zmieniło się od ostatniej synchronizacji.

Ile kosztuje połączenie przez API?

Połączenie przez API zaczyna się od 5 000 Kč miesięcznie. Dokładna cena zależy od liczby produktów i wybranych funkcji.

Gotowy do połączenia?

Przejrzyj dokumentację albo omówmy integrację razem. Odezwiemy się w ciągu 24 godzin.

Umów połączenie → Otwórz dokumentację ↗
Lenka