Overview

Partner-API (B2B)

A server-to-server API for B2B resellers and partners with a partner portal account to read the esimoa product catalog.

On this page

Who it is for
Getting access
Basis-URL
Endpunkte
Response envelope
Compared to the Public API

Who it is for#

Die Partner API richtet sich an B2B-Wiederverkäufer, Reisebüros und Firmenpartner mit einem Vertrag mit esimoa und einem Konto im Partnerportal. Deine Server können denselben Produktkatalog lesen, den esimoa verkauft, und darauf eigene Verkaufs- oder Support-Tools aufbauen.

Preise (priceKRW) sind esimoa-Verkaufspreise in KRW. Lieferanten- und Kosteninformationen sind nie in den Antworten enthalten.

Trinkgeld

Du betreibst einen Blog, ein Vergleichsportal oder ein KI-Produkt? Die Öffentliche API steht allen offen und bringt dir eine Provision ein.

Getting access#

1Partnerschaftsanfrage — kontaktiere uns zuerst. esimoa prüft die Anfrage und legt das Konto für dich an.
2Der Kontoinhaber (OWNER) erhält eine Einladungs-E-Mail. Der Link funktioniert einmalig innerhalb von 72 Stunden; leg ein Passwort fest, und du bist angemeldet.
3Partnerportal → API-Schlüssel: Erstelle deinen ersten Schlüssel.

Basis-URL#

url

https://api.esimoa.com/b2b/v1

Warnung

Nutze diese API von deinem Backend aus. CORS erlaubt keine Browseraufrufe von externen Websites. Liefere den Schlüssel niemals im Frontend- oder App-Code aus.

Endpunkte#

Endpunkt	Beschreibung
GET /b2b/v1/products	Produkte suchen
GET /b2b/v1/products/:id	Ein Produkt
GET /b2b/v1/countries	Länder mit Produkten

Jeder Endpunkt erfordert den catalog:read als Scope für den Schlüssel (standardmäßig erteilt).

Response envelope#

Bei Erfolg steht das Ergebnis in data, Listen enthalten zusätzlich total, page und limit. Fehler enthalten einen code – die Nachricht ist englisch und kann sich ändern, verzweige daher anhand von code.

json

// Success
{ "success": true, "data": ..., "total": 128, "page": 1, "limit": 20 }

// Error
{ "statusCode": 401, "code": "INVALID_API_KEY", "message": "The API key is invalid." }

Compared to the Public API#

	Partner-API (B2B)	Öffentliche API (/v1)
Schlüsselausgabe	Partnerportal	Dashboard des Entwicklerbereichs
Seitennavigation	`page (1~) · limit ≤ 50`	`offset · limit ≤ 50`
Preisfeld	`priceKRW`	`priceKrw`
Kauflink	Keine – Verkäufe richten sich nach deinem Vertrag	url (mit Partnercode)
Lieferanteninfo	Nicht enthalten	`provider`
Ratenlimit	300/Min. pro Schlüssel (pro Konto anpassbar)	600/Min. pro Partner