Overview

API partenaire (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 de base
Endpoints
Response envelope
Compared to the Public API

Who it is for#

La Partner API s’adresse aux revendeurs B2B, agences de voyage et partenaires professionnels sous contrat avec esimoa et disposant d’un compte sur le portail partenaire. Vos serveurs peuvent lire le même catalogue de produits que celui vendu par esimoa et créer vos propres outils de vente ou d’assistance.

Les prix (priceKRW) sont les prix de vente esimoa en KRW. Les réponses n’incluent jamais d’informations sur les fournisseurs ou les coûts.

Pourboire

Vous gérez un blog, un comparateur ou un produit d’IA ? Notre API publique est ouvert à tous et vous rapporte une commission.

Getting access#

1Demande de partenariat — contactez-nous d’abord. esimoa examine la demande et crée le compte pour vous.
2Le titulaire du compte (OWNER) reçoit un e-mail d’invitation. Le lien fonctionne une seule fois pendant 72 heures ; définissez un mot de passe et vous serez connecté.
3Portail partenaire → Clés API: générez votre première clé.

URL de base#

url

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

Avertissement

Utilisez cette API depuis votre backend. CORS n’autorise pas les appels depuis le navigateur sur des sites externes. N’incluez jamais la clé dans le code frontend ou de l’application.

Endpoints#

Endpoint	Description
GET /b2b/v1/products	Rechercher des produits
GET /b2b/v1/products/:id	Un produit
GET /b2b/v1/countries	Pays avec des produits

Chaque endpoint exige le catalog:read comme portée de la clé (accordée par défaut).

Response envelope#

En cas de succès, le résultat se trouve dans data, et les listes incluent aussi total, page et limit. Les erreurs comportent un code — le message est en anglais et peut changer, basez donc votre logique sur 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 partenaire (B2B)	API publique (/v1)
Émission des clés	Portail partenaire	Tableau de bord de l’Espace développeurs
Pagination	`page (1~) · limit ≤ 50`	`offset · limit ≤ 50`
Champ du prix	`priceKRW`	`priceKrw`
Lien d’achat	Aucun — les ventes suivent votre contrat	url (avec code partenaire)
Infos fournisseur	Non inclus	`provider`
Limite de requêtes	300/min par clé (ajustable par compte)	600/min par partenaire