REST API V2

Kapcsolja a Pobót a rendszeréhez REST API-n keresztül

Importálja tömegesen a termékeket és kategóriákat, és töltse le a kész termékleírásokat minden nyelven. Fejlesztőknek, akik a Pobót saját webáruházukhoz vagy információs rendszerükhöz kapcsolják.

Dokumentáció megnyitása ↗ Kapcsolat egyeztetése
curl "https://api.pobo.space/api/v2/rest/products?is_edited=true&lang=default,sk" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Hogyan működik

  1. 1

    Hozzon létre API-tokent

    A Pobo adminisztrációjában kattintson a Generate API token gombra, és küldje az Authorization fejlécben.

  2. 2

    Küldje el a katalógusát

    Importálja a termékeket, kategóriákat, márkákat és paramétereket legfeljebb 100 tételes kötegekben.

  3. 3

    Hozza létre a tartalmat a Pobóban

    A csapata a szerkesztőben készíti el a leírásokat, vagy az AI-val generáltatja őket.

  4. 4

    Töltse le a kész tartalmat

    Kérje le a kész HTML-t minden nyelven, és tegye közzé a webáruházában.

Importálja a katalógust egyetlen kéréssel

Egyszerre legfeljebb 100 terméket küldhet. Kötelező csak az id, az is_visible, az alapértelmezett név és az URL. A Pobo az Ön id-ja alapján párosítja a termékeket, így ugyanaz a kérés frissíti is őket.

Kérés

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

Válasz

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

Az API egy pillantásra

Az alap URL: https://api.pobo.space. Az egyes végpontok részletei a dokumentációban találhatók.

Termékek/api/v2/rest/productsGETPOSTDELETE
Kategóriák/api/v2/rest/categoriesGETPOSTDELETE
Márkák/api/v2/rest/brandsGETPOSTDELETE
Blogok/api/v2/rest/blogsGETPOSTDELETE
Paraméterek/api/v2/rest/parametersPOST
Több entitás atomi importja/api/v2/rest/multi-importPOST

Amit visszakap

content.html

Kész HTML

A content.html mező a megjelenített leírást tartalmazza, készen a termékoldalra való beillesztésre.

include=marketplace

HTML piactereknek

Egyszerűsített HTML azoknak a piactereknek, amelyek csak korlátozott jelölést engednek.

include=nested

Strukturált JSON

Widgetek beágyazott JSON-ként, ha a tartalmat saját maga szeretné megjeleníteni.

include=rich_snippet

Rich snippetek

Strukturált adatok keresőmotoroknak, készen az oldalba illesztésre.

lang=all

Hét nyelvi változat

default, cs, sk, en, de, pl és hu. A lang paraméter nélkül csak a default változatot kapja.

last_update_time_from

Csak ami megváltozott

Szűrje a Pobóban szerkesztett tételeket és a legutóbbi szinkronizálás óta történt változásokat.

Szabályok, amelyeket érdemes ismerni

  • A tokent az Authorization: Bearer YOUR_API_TOKEN fejlécben küldje
  • Legfeljebb 100 tétel egy import vagy törlési kérésben
  • A listák a page és per_page paraméterekkel lapozhatók, oldalanként legfeljebb 100 tétellel
  • A törlés logikai, a tartalom a Pobóban marad
  • Az id mező az Ön saját azonosítója, a Pobo a következő importnál ez alapján párosítja a tételeket
  • Használja az API V2-t. A V1 csak a meglévő integrációk miatt marad, és csak az alapértelmezett nyelvvel működik

Gyakran ismételt kérdések

Van tesztkörnyezet?

Létrehozunk Önnek egy tesztfiókot, hogy az indulás előtt kipróbálhassa a kapcsolatot a saját termékein.

Mi a különbség az API V1 és V2 között?

A V2 a tartalom összes nyelvi változatával dolgozik. A V1 csak az alapértelmezett nyelvvel működik, és a meglévő integrációk miatt marad meg.

Mennyi ideig tart általában a csatlakozás?

Általában 2 hét az aláírástól az éles indulásig. A pontos becslést a találkozó után kapod meg, ahol átbeszéljük a terjedelmet és az igényeidet.

Értesíti a Pobo a rendszeremet a változásokról?

Egyelőre nem automatikusan. Töltse le a tartalmat rendszeresen, és használja a last_update_time_from szűrőt, hogy csak a legutóbbi szinkronizálás óta történt változásokat kapja meg.

Mennyibe kerül az API-kapcsolat?

Az API-kapcsolat havi 5 000 Kč-tól indul. A pontos ár a termékek számától és a választott funkcióktól függ.

Készen áll a kapcsolódásra?

Nézze át a dokumentációt, vagy menjünk végig együtt az integráción. 24 órán belül jelentkezünk.

Kapcsolat egyeztetése → Dokumentáció megnyitása ↗
Lenka