Overview

API per partner (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
URL di base
Endpoint
Response envelope
Compared to the Public API

Who it is for#

La Partner API è pensata per rivenditori B2B, agenzie di viaggio e partner aziendali con un contratto con esimoa e un account sul portale partner. I tuoi server possono leggere lo stesso catalogo di prodotti venduto da esimoa e costruirci sopra strumenti di vendita o assistenza.

I prezzi (priceKRW) sono i prezzi di vendita di esimoa in KRW. Le risposte non includono mai informazioni su fornitori o costi.

Mancia

Gestisci un blog, un comparatore o un prodotto di IA? La nostra API pubblica è aperto a tutti e ti fa guadagnare una commissione.

Getting access#

1Richiesta di collaborazione — contattaci prima. esimoa esamina la richiesta e crea l’account per te.
2Il titolare dell’account (OWNER) riceve un’email di invito. Il link funziona una sola volta entro 72 ore; imposta una password e accederai subito.
3Portale partner → Chiavi API: genera la tua prima chiave.

URL di base#

url

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

Attenzione

Usa questa API dal tuo backend. CORS non consente chiamate da browser su siti esterni. Non inserire mai la chiave nel codice frontend o dell’app.

Endpoint#

Endpoint	Descrizione
GET /b2b/v1/products	Cerca prodotti
GET /b2b/v1/products/:id	Un prodotto
GET /b2b/v1/countries	Paesi con prodotti

Ogni endpoint richiede lo catalog:read come ambito della chiave (concesso per impostazione predefinita).

Response envelope#

In caso di successo il risultato è in data, e gli elenchi includono anche total, page e limit. Gli errori contengono un code: il messaggio è in inglese e può cambiare, quindi basa la logica su 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#

	API per partner (B2B)	API pubblica (/v1)
Emissione delle chiavi	Portale partner	Dashboard del Centro sviluppatori
Paginazione	`page (1~) · limit ≤ 50`	`offset · limit ≤ 50`
Campo prezzo	`priceKRW`	`priceKrw`
Link di acquisto	Nessuno — le vendite seguono il tuo contratto	url (con codice partner)
Info fornitore	Non incluso	`provider`
Limite di richieste	300/min per chiave (regolabile per account)	600/min per partner