REST API V2

Napojte Pobo na svoj systém cez REST API

Hromadne importujte produkty a kategórie a sťahujte hotové produktové popisy vo všetkých jazykoch. Pre vývojárov, ktorí napájajú Pobo na vlastný e-shop alebo informačný systém.

Otvoriť dokumentáciu ↗ Dohodnúť napojenie
curl "https://api.pobo.space/api/v2/rest/products?is_edited=true&lang=default,sk" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Ako to funguje

  1. 1

    Vygenerujte API token

    V administrácii Pobo kliknite na Generate API token a posielajte ho v hlavičke Authorization.

  2. 2

    Pošlite svoj katalóg

    Importujte produkty, kategórie, značky a parametre v dávkach až po 100 položiek.

  3. 3

    Vytvorte obsah v Pobo

    Váš tím poskladá popisy v editore, alebo ich nechá vygenerovať AI.

  4. 4

    Stiahnite hotový obsah

    Získajte hotové HTML vo všetkých jazykoch a zverejnite ho vo svojom e-shope.

Importujte katalóg jednou požiadavkou

Pošlite až 100 produktov naraz. Povinné sú len id, is_visible, predvolený názov a URL. Pobo páruje produkty podľa vášho id, takže rovnaká požiadavka ich aj aktualizuje.

Požiadavka

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

Odpoveď

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

API na jeden pohľad

Základná URL je https://api.pobo.space. Podrobnosti ku každému endpointu nájdete v dokumentácii.

Produkty/api/v2/rest/productsGETPOSTDELETE
Kategórie/api/v2/rest/categoriesGETPOSTDELETE
Značky/api/v2/rest/brandsGETPOSTDELETE
Blogy/api/v2/rest/blogsGETPOSTDELETE
Parametre/api/v2/rest/parametersPOST
Atomický import viacerých entít/api/v2/rest/multi-importPOST

Čo dostanete späť

content.html

Hotové HTML

Pole content.html obsahuje vykreslený popis, pripravený na vloženie na stránku produktu.

include=marketplace

HTML pre marketplace

Zjednodušené HTML pre marketplace, ktoré povoľujú len obmedzené značky.

include=nested

Štruktúrovaný JSON

Widgety ako vnorený JSON, ak chcete obsah vykresľovať sami.

include=rich_snippet

Rich snippets

Štruktúrované dáta pre vyhľadávače, pripravené na vloženie do stránky.

lang=all

Sedem jazykových variantov

default, cs, sk, en, de, pl a hu. Bez parametra lang dostanete len default.

last_update_time_from

Len to, čo sa zmenilo

Filtrujte položky upravené v Pobo a zmeny od poslednej synchronizácie.

Pravidlá, ktoré sa oplatí poznať

  • Token posielajte v hlavičke Authorization: Bearer YOUR_API_TOKEN
  • Až 100 položiek v jednej požiadavke na import alebo zmazanie
  • Zoznamy sa stránkujú parametrami page a per_page, najviac 100 položiek na stránku
  • Mazanie je mäkké, obsah v Pobo zostáva
  • Pole id je váš vlastný identifikátor, podľa neho Pobo páruje položky pri ďalšom importe
  • Používajte API V2. V1 zostáva len pre existujúce integrácie a pracuje iba s predvoleným jazykom

Často kladené otázky

Existuje testovacie prostredie?

Vytvoríme vám testovací účet, aby ste si napojenie vyskúšali na vlastných produktoch ešte pred spustením.

Aký je rozdiel medzi API V1 a V2?

V2 pracuje so všetkými jazykovými verziami vášho obsahu. V1 pracuje len s predvoleným jazykom a zostáva kvôli existujúcim integráciám.

Ako dlho napojenie zvyčajne trvá?

Zvyčajne 2 týždne od podpisu po ostrú prevádzku. Presný odhad dostanete po stretnutí, na ktorom prejdeme rozsah a vaše požiadavky.

Dá Pobo môjmu systému vedieť o zmenách?

Zatiaľ nie automaticky. Sťahujte obsah pravidelne a použite filter last_update_time_from, aby ste dostali len to, čo sa od poslednej synchronizácie zmenilo.

Koľko stojí napojenie cez API?

Napojenie cez API začína na 5 000 Kč mesačne. Presná cena závisí od počtu produktov a zvolených funkcií.

Pripravení sa napojiť?

Prejdite si dokumentáciu, alebo si integráciu prejdeme spolu. Ozveme sa do 24 hodín.

Dohodnúť napojenie → Otvoriť dokumentáciu ↗
Lenka