Pengembang

HTTP API

URL dasar https://osim.live/api/v1 — verifikasi SMS dan eSIM perjalanan. Buat kunci di dasbor, lalu panggil dengan Bearer.

Autentikasi

Kirim kunci API di setiap permintaan privat. Kunci diawali osim_ dan dibuat di halaman akun.

Authorization: Bearer osim_…

Jangan pernah menaruh kunci di frontend publik. Utamakan sisi server atau proxy backend.

Buka kunci di dasbor

Format respons

Setiap endpoint mengembalikan JSON dengan tanda success. Error memakai bentuk yang sama, dengan string error.

// Success
{ "success": true, "data": { … } }

// Error
{ "success": false, "error": "message" }

URL dasar: https://osim.live/api/v1
Content-Type: application/json
CORS aktif untuk klien peramban (OPTIONS didukung)
Jumlah dalam USD cents kecuali disebutkan lain (balanceCents, sellCents)

GET/api/v1

Indeks API — versi dan jalur sumber yang tersedia. Tanpa kunci.

Publik

curl https://osim.live/api/v1

GET/api/v1/me

Akun yang terikat pada kunci API: id, email, name, dan saldo dompet.

Bearer wajib

curl https://osim.live/api/v1/me \
  -H "Authorization: Bearer osim_…"

// data
{
  "id": "…",
  "email": "[email protected]",
  "name": "…",
  "balanceCents": 2500,
  "balance": "$25.00"
}

Verifikasi SMS

GET/api/v1/sms?catalog=1

Katalog publik layanan, negara, harga USD, dan durasi sewa yang diizinkan.

Publik

curl "https://osim.live/api/v1/sms?catalog=1"

// data
{
  "services": [
    {
      "slug": "whatsapp",
      "service": "WhatsApp",
      "category": "…",
      "countries": [
        { "code": "TR", "name": "Turkey", "countryId": 12, "priceUsd": 0.35, "successRate": 92 }
      ]
    }
  ],
  "rentHours": [4, 12, 24, 72, 168]
}

GET/api/v1/sms

Daftar pesanan SMS terbaru Anda.

Bearer wajib

Bawaan: 50 pesanan SMS terakhir pemilik kunci

curl https://osim.live/api/v1/sms \
  -H "Authorization: Bearer osim_…"

POST/api/v1/sms

Beli, sewa, cek status, batal, selesai, atau kirim ulang. Call-verify tidak tersedia.

Bearer wajib

Isi bersama

Kolom	Tipe	Wajib	Deskripsi
`action`	string	ya	purchase \| activation \| rent \| status \| refresh \| cancel \| complete \| resend
`service / serviceSlug`	string	ya	Slug katalog, mis. whatsapp
`countryId / country`	number	tidak	Id negara penyedia dari katalog (wajib untuk beli dan sewa)
`priceId`	string	tidak	Kunci opsional ke baris harga tertentu
`maxPrice`	number	tidak	Plafon USD opsional
`operator`	string	tidak	Preferensi jaringan opsional
`hours / time`	number	tidak	Hanya sewa: 4 \| 12 \| 24 \| 72 \| 168
`id / activationId`	string	tidak	Id pesanan untuk status, batal, selesai, dan kirim ulang

purchase / activation

Nomor verifikasi SMS sekali pakai (~20 menit). Verifikasi lewat telepon tidak tersedia.

curl -X POST https://osim.live/api/v1/sms \
  -H "Authorization: Bearer osim_…" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "purchase",
    "service": "whatsapp",
    "countryId": 12
  }'

rent

Sewa lebih lama. Jam yang diizinkan: 4, 12, 24, 72, 168.

{
  "action": "rent",
  "service": "telegram",
  "countryId": 16,
  "hours": 24
}

status / refresh

{ "action": "status", "id": "cm…" }

cancel · complete · resend

{ "action": "cancel", "id": "cm…" }
{ "action": "complete", "id": "cm…" }
{ "action": "resend", "id": "cm…" }  // jalur sewa hanya jika didukung

eSIM perjalanan

GET/api/v1/esim?catalog=1

Katalog paket publik (slug / packageCode, data, hari, harga jual).

Publik

curl "https://osim.live/api/v1/esim?catalog=1"

GET/api/v1/esim

Daftar pesanan eSIM Anda, atau ambil satu berdasarkan id (pemakaian disegarkan jika memungkinkan).

Bearer wajib

Bawaan: 50 pesanan eSIM terakhir
Satu pesanan + segarkan pemakaian: ?id=cm…

curl "https://osim.live/api/v1/esim?id=cm…" \
  -H "Authorization: Bearer osim_…"

POST/api/v1/esim

Beli paket, segarkan profil, ganti nama, lihat opsi isi ulang, atau terapkan isi ulang.

Bearer wajib

Kolom	Tipe	Wajib	Deskripsi
`action`	string	ya	purchase \| refresh \| rename \| topup-options \| topup
`slug / packageCode`	string	tidak	Paket katalog untuk pembelian dan isi ulang
`id`	string	tidak	Id pesanan untuk segarkan, ganti nama, dan isi ulang
`label`	string	tidak	Nama tampilan baru untuk ganti nama

// Purchase
{
  "action": "purchase",
  "packageCode": "turkey-5gb-30d"
}

// Refresh profile / usage
{ "action": "refresh", "id": "cm…" }

// Rename
{ "action": "rename", "id": "cm…", "label": "Trip TR" }

// Top-up options + apply
{ "action": "topup-options", "id": "cm…" }
{ "action": "topup", "id": "cm…", "packageCode": "…" }

Respons pembelian berisi string aktivasi LPA dan URL gambar QR jika tersedia.

Error

HTTP	Kapan
`200`	`success: true`
`400`	Kesalahan validasi / bisnis (saldo tidak cukup, aksi tidak dikenal, …)
`401`	Kunci API tidak ada atau tidak valid
`404`	Pesanan tidak ditemukan untuk akun ini

Catatan

Saldo dipotong dalam sen USD saat pembelian. Pembelian penyedia yang gagal dikembalikan.
Nomor SMS sekali pakai biasanya berlaku ~20 menit. Sewa memakai jam dari katalog.
Batas laju dan kontrol penyalahgunaan dapat berlaku. Hubungi dukungan untuk volume lebih tinggi.
Ekspor OpenAPI/Swagger belum dipublikasikan — halaman ini adalah acuan utama.