Overview
API para socios (B2B)
A server-to-server API for B2B resellers and partners with a partner portal account to read the esimoa product catalog.
Who it is for#
La Partner API es para revendedores B2B, agencias de viajes y socios corporativos con contrato con esimoa y cuenta en el portal de socios. Tus servidores pueden leer el mismo catálogo de productos que vende esimoa y crear sobre él tus propias herramientas de venta o soporte.
Los precios (priceKRW) son precios de venta al público de esimoa en KRW. Las respuestas nunca incluyen información de proveedores ni de costes.
Propina
Getting access#
- 1Solicitud de colaboración — contáctanos primero. esimoa revisará la solicitud y creará la cuenta por ti.
- 2El titular de la cuenta (OWNER) recibe un correo de invitación. El enlace funciona una sola vez en un plazo de 72 horas; establece una contraseña y se iniciará tu sesión.
- 3Portal de socios → Claves de API: genera tu primera clave.
URL base#
https://api.esimoa.com/b2b/v1Advertencia
Endpoints#
| Endpoint | Descripción |
|---|---|
| GET /b2b/v1/products | Buscar productos |
| GET /b2b/v1/products/:id | Un producto |
| GET /b2b/v1/countries | Países con productos |
Todos los endpoints requieren el catalog:read como ámbito de la clave (concedido por defecto).
Response envelope#
Si la solicitud tiene éxito, el resultado está en data, y las listas incluyen además total, page y limit. Los errores incluyen un code: el mensaje está en inglés y puede cambiar, así que basa tu lógica en code.
// 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 para socios (B2B) | API pública (/v1) | |
|---|---|---|
| Emisión de claves | Portal de socios | Panel del Centro para desarrolladores |
| Paginación | page (1~) · limit ≤ 50 | offset · limit ≤ 50 |
| Campo de precio | priceKRW | priceKrw |
| Enlace de compra | Ninguno: las ventas se rigen por tu contrato | url (con código de partner) |
| Información del proveedor | No incluido | provider |
| Límite de solicitudes | 300/min por clave (ajustable por cuenta) | 600/min por socio |