Overview

API mitra (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 dasar
Endpoint
Response envelope
Compared to the Public API

Who it is for#

Partner API ditujukan bagi reseller B2B, agen perjalanan, dan mitra korporat yang memiliki kontrak dengan esimoa serta akun portal mitra. Server Anda dapat membaca katalog produk yang sama dengan yang dijual esimoa dan membangun alat penjualan atau dukungan sendiri di atasnya.

Harga (priceKRW) adalah harga eceran esimoa dalam KRW. Respons tidak pernah menyertakan informasi pemasok atau biaya.

Tip

Mengelola blog, situs perbandingan, atau produk AI? API Publik terbuka untuk semua orang dan memberi Anda komisi.

Getting access#

1Permintaan kemitraan — hubungi kami terlebih dahulu. esimoa akan meninjau permintaan dan membuatkan akun untuk Anda.
2Pemilik akun (OWNER) menerima email undangan. Tautan hanya berlaku sekali dalam 72 jam; atur kata sandi dan Anda akan langsung masuk.
3Portal mitra → Kunci API: buat kunci pertama Anda.

URL dasar#

url

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

Peringatan

Gunakan API ini dari backend Anda. CORS tidak mengizinkan panggilan browser dari situs eksternal. Jangan pernah menyertakan kunci di kode frontend atau aplikasi.

Endpoint#

Endpoint	Deskripsi
GET /b2b/v1/products	Cari produk
GET /b2b/v1/products/:id	Satu produk
GET /b2b/v1/countries	Negara dengan produk

Setiap endpoint memerlukan catalog:read pada cakupan kunci (diberikan secara default).

Response envelope#

Jika berhasil, hasilnya ada di data, dan daftar juga menyertakan total, page, dan limit. Error membawa code — pesannya berbahasa Inggris dan dapat berubah, jadi buat percabangan berdasarkan 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 mitra (B2B)	API Publik (/v1)
Penerbitan kunci	Portal mitra	Dasbor Pusat Pengembang
Paginasi	`page (1~) · limit ≤ 50`	`offset · limit ≤ 50`
Kolom harga	`priceKRW`	`priceKrw`
Tautan pembelian	Tidak ada — penjualan mengikuti kontrak Anda	url (dengan kode mitra)
Info pemasok	Tidak termasuk	`provider`
Batas laju	300/menit per kunci (dapat disesuaikan per akun)	600/menit per mitra