REST API V2

Binden Sie Pobo per REST API an Ihr System an

Importieren Sie Produkte und Kategorien in großen Mengen und laden Sie fertige Produktbeschreibungen in allen Sprachen herunter. Für Entwickler, die Pobo an ihren eigenen E-Shop oder ihr Informationssystem anbinden.

Dokumentation öffnen ↗ Anbindung vereinbaren
curl "https://api.pobo.space/api/v2/rest/products?is_edited=true&lang=default,sk" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Wie es funktioniert

  1. 1

    Erzeugen Sie ein API-Token

    Klicken Sie in der Pobo-Administration auf Generate API token und senden Sie es im Header Authorization.

  2. 2

    Senden Sie Ihren Katalog

    Importieren Sie Produkte, Kategorien, Marken und Parameter in Stapeln von bis zu 100 Einträgen.

  3. 3

    Erstellen Sie die Inhalte in Pobo

    Ihr Team erstellt die Beschreibungen im Editor oder lässt sie von der KI generieren.

  4. 4

    Laden Sie die fertigen Inhalte herunter

    Holen Sie sich das fertige HTML in allen Sprachen und veröffentlichen Sie es in Ihrem E-Shop.

Importieren Sie Ihren Katalog mit einer Anfrage

Senden Sie bis zu 100 Produkte auf einmal. Pflicht sind nur id, is_visible, der Standardname und die URL. Pobo ordnet Produkte anhand Ihrer id zu, dieselbe Anfrage aktualisiert sie also auch.

Anfrage

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

Antwort

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

Die API auf einen Blick

Die Basis-URL ist https://api.pobo.space. Details zu jedem Endpunkt finden Sie in der Dokumentation.

Produkte/api/v2/rest/productsGETPOSTDELETE
Kategorien/api/v2/rest/categoriesGETPOSTDELETE
Marken/api/v2/rest/brandsGETPOSTDELETE
Blogs/api/v2/rest/blogsGETPOSTDELETE
Parameter/api/v2/rest/parametersPOST
Atomarer Import mehrerer Entitäten/api/v2/rest/multi-importPOST

Was Sie zurückbekommen

content.html

Fertiges HTML

Das Feld content.html enthält die gerenderte Beschreibung, bereit zum Einfügen auf der Produktseite.

include=marketplace

HTML für Marktplätze

Vereinfachtes HTML für Marktplätze, die nur eingeschränktes Markup erlauben.

include=nested

Strukturiertes JSON

Widgets als verschachteltes JSON, wenn Sie die Inhalte selbst rendern möchten.

include=rich_snippet

Rich Snippets

Strukturierte Daten für Suchmaschinen, bereit zum Einfügen in die Seite.

lang=all

Sieben Sprachvarianten

default, cs, sk, en, de, pl und hu. Ohne den Parameter lang erhalten Sie nur default.

last_update_time_from

Nur was sich geändert hat

Filtern Sie in Pobo bearbeitete Einträge und Änderungen seit Ihrer letzten Synchronisation.

Regeln, die man kennen sollte

  • Das Token gehört in den Header Authorization: Bearer YOUR_API_TOKEN
  • Bis zu 100 Einträge in einer Import- oder Löschanfrage
  • Listen werden mit page und per_page paginiert, höchstens 100 Einträge pro Seite
  • Das Löschen ist weich, die Inhalte bleiben in Pobo
  • Das Feld id ist Ihre eigene Kennung, anhand derer Pobo Einträge beim nächsten Import zuordnet
  • Verwenden Sie API V2. V1 bleibt nur für bestehende Integrationen und arbeitet nur mit der Standardsprache

Häufig gestellte Fragen

Gibt es eine Testumgebung?

Wir erstellen Ihnen ein Testkonto, damit Sie die Anbindung vor dem Start mit Ihren eigenen Produkten ausprobieren können.

Was ist der Unterschied zwischen API V1 und V2?

V2 arbeitet mit allen Sprachversionen Ihrer Inhalte. V1 arbeitet nur mit der Standardsprache und bleibt für bestehende Integrationen erhalten.

Wie lange dauert die Anbindung normalerweise?

In der Regel 2 Wochen von der Unterschrift bis zum Livebetrieb. Eine genaue Schätzung erhalten Sie nach unserem Termin, bei dem wir den Umfang und Ihre Anforderungen besprechen.

Benachrichtigt Pobo mein System über Änderungen?

Noch nicht automatisch. Laden Sie die Inhalte regelmäßig herunter und nutzen Sie den Filter last_update_time_from, damit Sie nur erhalten, was sich seit der letzten Synchronisation geändert hat.

Was kostet die API-Anbindung?

Die API-Anbindung beginnt bei 5 000 Kč pro Monat. Der genaue Preis hängt von der Anzahl der Produkte und den gewählten Funktionen ab.

Bereit für die Anbindung?

Sehen Sie sich die Dokumentation an oder gehen wir Ihre Integration gemeinsam durch. Wir melden uns innerhalb von 24 Stunden.

Anbindung vereinbaren → Dokumentation öffnen ↗
Lenka