REST API V2

Napojte Pobo na svůj systém přes REST API

Hromadně importujte produkty a kategorie a stahujte hotové produktové popisky ve všech jazycích. Pro vývojáře, kteří napojují Pobo na vlastní e-shop nebo informační systém.

Otevřít dokumentaci ↗ Domluvit napojení
curl "https://api.pobo.space/api/v2/rest/products?is_edited=true&lang=default,sk" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Jak to funguje

  1. 1

    Vygenerujte API token

    V administraci Pobo klikněte na Generate API token a posílejte ho v hlavičce Authorization.

  2. 2

    Pošlete svůj katalog

    Importujte produkty, kategorie, značky a parametry v dávkách až po 100 položkách.

  3. 3

    Vytvořte obsah v Pobo

    Váš tým poskládá popisky v editoru, nebo je nechá vygenerovat AI.

  4. 4

    Stáhněte hotový obsah

    Získejte hotové HTML ve všech jazycích a zveřejněte ho ve svém e-shopu.

Importujte katalog jedním požadavkem

Pošlete až 100 produktů najednou. Povinné jsou jen id, is_visible, výchozí název a URL. Pobo páruje produkty podle vašeho id, takže stejný požadavek je i aktualizuje.

Požadavek

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"]
  }
]

Odpověď

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

API na jeden pohled

Základní URL je https://api.pobo.space. Podrobnosti ke každému endpointu najdete v dokumentaci.

Produkty/api/v2/rest/productsGETPOSTDELETE
Kategorie/api/v2/rest/categoriesGETPOSTDELETE
Značky/api/v2/rest/brandsGETPOSTDELETE
Blogy/api/v2/rest/blogsGETPOSTDELETE
Parametry/api/v2/rest/parametersPOST
Atomický import více entit/api/v2/rest/multi-importPOST

Co dostanete zpět

content.html

Hotové HTML

Pole content.html obsahuje vykreslený popisek, připravený k vložení na stránku produktu.

include=marketplace

HTML pro marketplace

Zjednodušené HTML pro marketplace, které povolují jen omezené značky.

include=nested

Strukturovaný JSON

Widgety jako vnořený JSON, pokud chcete obsah vykreslovat sami.

include=rich_snippet

Rich snippets

Strukturovaná data pro vyhledávače, připravená k vložení do stránky.

lang=all

Sedm jazykových variant

default, cs, sk, en, de, pl a hu. Bez parametru lang dostanete jen default.

last_update_time_from

Jen to, co se změnilo

Filtrujte položky upravené v Pobo a změny od poslední synchronizace.

Pravidla, která se vyplatí znát

  • Token posílejte v hlavičce Authorization: Bearer YOUR_API_TOKEN
  • Až 100 položek v jednom požadavku na import nebo smazání
  • Seznamy se stránkují parametry page a per_page, nejvýš 100 položek na stránku
  • Mazání je měkké, obsah v Pobo zůstává
  • Pole id je váš vlastní identifikátor, podle něj Pobo páruje položky při dalším importu
  • Používejte API V2. V1 zůstává jen pro stávající integrace a pracuje pouze s výchozím jazykem

Často kladené dotazy

Existuje testovací prostředí?

Vytvoříme vám testovací účet, abyste si napojení vyzkoušeli na vlastních produktech ještě před spuštěním.

Jaký je rozdíl mezi API V1 a V2?

V2 pracuje se všemi jazykovými verzemi vašeho obsahu. V1 pracuje jen s výchozím jazykem a zůstává kvůli stávajícím integracím.

Jak dlouho napojení obvykle trvá?

Obvykle 2 týdny od podepsání po ostrý provoz. Přesný odhad dostanete po schůzce, kdy probereme rozsah a vaše požadavky.

Dá Pobo mému systému vědět o změnách?

Zatím ne automaticky. Stahujte obsah pravidelně a použijte filtr last_update_time_from, ať dostanete jen to, co se od poslední synchronizace změnilo.

Kolik stojí napojení přes API?

Napojení přes API začíná na 5 000 Kč měsíčně. Přesná cena závisí na počtu produktů a zvolených funkcích.

Připraveni se napojit?

Projděte si dokumentaci, nebo si integraci projdeme spolu. Ozveme se do 24 hodin.

Domluvit napojení → Otevřít dokumentaci ↗
Lenka