Overview

API Publik (/v1)

Shared rules of the /v1 API: base URL, response envelope, pagination and response language.

On this page

URL dasar
Endpoint
Response envelope
Paginasi
Response language
Prices & caching

URL dasar#

Kirim setiap permintaan melalui HTTPS ke alamat di bawah. Kunci API Publik diperlukan (Autentikasi), dan semua respons berformat JSON.

url

https://api.esimoa.com/v1

Endpoint#

Endpoint	Deskripsi
GET /v1/esims	Cari eSIM
GET /v1/esims/:id	Dapatkan eSIM
GET /v1/countries	Daftar negara
GET /v1/openapi.json	Spesifikasi OpenAPI 3.1 (tanpa kunci)

Response envelope#

Respons yang berhasil selalu menyertakan "success": true. Daftar dikirim dalam items dan hasil tunggal dalam item.

json

// List endpoints
{ "success": true, "items": [ ... ], "total": 42, "limit": 10, "offset": 0, "sort": "price" }

// Detail endpoint
{ "success": true, "item": { ... } }

Untuk respons error dan kode status, lihat Batas laju & kesalahan.

Paginasi#

Daftar dipaginasi dengan limit (1–50, default 10) dan offset. offset selalu dibulatkan ke bawah ke kelipatan limit — misalnya limit=10, offset=15 diperlakukan sebagai offset=10. offset dalam respons adalah nilai yang benar-benar digunakan, dan total adalah jumlah keseluruhan.

Tip

Minta halaman berikutnya dengan offset + limit. Offset yang bukan kelipatan limit dapat mengulang item antarhalaman, karena itu dibulatkan ke bawah.

Response language#

Parameter lang (ko | en | ja | zh-CN | zh-TW, default en) mengatur bahasa nama negara, judul item, dan halaman pembelian yang dituju url. Sesuaikan dengan bahasa pengguna Anda.

Prices & caching#

Harga (priceKrw) adalah harga jual esimoa dalam KRW berupa bilangan bulat. Harga sering berubah — simpan cache hasil pencarian paling lama beberapa menit; checkout esimoa selalu menjadi acuan jumlah yang ditagih.