Dokumentasi API

Hubungkan bot atau website Anda ke Sandeva Nokos. Harga, potongan saldo, dan refund otomatis sama persis dengan website.

Autentikasi

Buat API key di menu Profil. Kirim lewat parameter apikey atau header X-API-Key.

Base URL: https://sandevanokos.web.id/api/public/v1

Semua endpoint bisa dipanggil dengan GET (query string) atau POST (JSON body). Respons selalu JSON dengan field success; jika gagal ada field error.

Kode server

server=5 — Sandeva Nokos 1 · Server 1 (kode negara angka, pakai varian)
server=1 — Sandeva Nokos 2 · Server 1 (kode negara angka, pakai operator)
server=2 — Sandeva Nokos 2 · Server 2 (kode negara angka, pakai varian)
server=3 — Sandeva Nokos 2 · Server 3 (kode negara angka)
server=4 — Sandeva Nokos 2 · Server 4 (kode negara ISO seperti id, pakai varian)
server=6 — Sandeva Nokos 2 · Server 5 (kode negara angka)

Akun & Order

GET/profile— Info akun & saldo

Contoh Request
https://sandevanokos.web.id/api/public/v1/profile?apikey=API_KEY_ANDA
Contoh Respons
{
  "success": true,
  "email": "user@email.com",
  "name": "Budi",
  "balance": 150000,
  "suspended": false
}

GET/countries— Daftar negara per server

Contoh Request
https://sandevanokos.web.id/api/public/v1/countries?apikey=API_KEY_ANDA&server=3
Contoh Respons
{
  "success": true,
  "countries": [
    { "code": "6", "name": "Indonesia", "flag": "🇮🇩" }
  ]
}

GET/services— Daftar layanan, stok & harga jual. Server bervarian (2, 4, 5, 6) mengembalikan field provider untuk memilih varian

Contoh Request
https://sandevanokos.web.id/api/public/v1/services?apikey=API_KEY_ANDA&server=3&country=6
Contoh Respons
{
  "success": true,
  "services": [
    {
      "produk": "wa",
      "name": "WhatsApp",
      "count": 120,
      "provider": "77",
      "price": 3500
    }
  ]
}

GET/operators— Daftar operator seluler (server 1 & 4) — any = acak

Contoh Request
https://sandevanokos.web.id/api/public/v1/operators?apikey=API_KEY_ANDA&server=1&country=6
Contoh Respons
{
  "success": true,
  "operators": ["any", "telkomsel", "indosat", "xl"]
}

GET/status— Cek status & OTP order

Contoh Request
https://sandevanokos.web.id/api/public/v1/status?apikey=API_KEY_ANDA&id=ORDER_ID
Contoh Respons
{
  "success": true,
  "order": {
    "id": "ORDER_ID",
    "server": "3",
    "country": "6",
    "country_name": "Indonesia",
    "service": "wa",
    "service_name": "WhatsApp",
    "operator": null,
    "number": "6281234567890",
    "otp": "123456",
    "status": "success",
    "price": 3500,
    "refunded": false,
    "expires_at": "2026-10-01T10:20:00Z",
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/cancel— Batalkan order yang belum menerima OTP (minimal 1 menit setelah order) — saldo kembali

Contoh Request
https://sandevanokos.web.id/api/public/v1/cancel?apikey=API_KEY_ANDA&id=ORDER_ID
Contoh Respons
{
  "success": true
}

GET/history— Riwayat order terakhir (limit 1–100, default 20)

Contoh Request
https://sandevanokos.web.id/api/public/v1/history?apikey=API_KEY_ANDA&limit=20
Contoh Respons
{
  "success": true,
  "orders": [ { "id": "ORDER_ID", "status": "success", "otp": "123456", "...": "..." } ]
}

Order Nomor (per server)

Semua order memakai endpoint /order. Saldo langsung dipotong; jika gagal atau tidak ada OTP sampai batas waktu, saldo kembali otomatis.

GET/order— Sandeva Nokos 1 · Server 1 (server=5) — parameter provider = varian dari /services

Contoh Request
https://sandevanokos.web.id/api/public/v1/order?apikey=API_KEY_ANDA&server=5&country=6&produk=wa&provider=2500
Contoh Respons
{
  "success": true,
  "order": {
    "id": "ORDER_ID",
    "server": "3",
    "country": "6",
    "country_name": "Indonesia",
    "service": "wa",
    "service_name": "WhatsApp",
    "operator": null,
    "number": "6281234567890",
    "otp": null,
    "status": "pending",
    "price": 3500,
    "refunded": false,
    "expires_at": "2026-10-01T10:20:00Z",
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/order— Sandeva Nokos 2 · Server 1 (server=1) — pilih operator (any = acak)

Contoh Request
https://sandevanokos.web.id/api/public/v1/order?apikey=API_KEY_ANDA&server=1&country=6&produk=wa&operator=any
Contoh Respons
{
  "success": true,
  "order": {
    "id": "ORDER_ID",
    "server": "3",
    "country": "6",
    "country_name": "Indonesia",
    "service": "wa",
    "service_name": "WhatsApp",
    "operator": null,
    "number": "6281234567890",
    "otp": null,
    "status": "pending",
    "price": 3500,
    "refunded": false,
    "expires_at": "2026-10-01T10:20:00Z",
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/order— Sandeva Nokos 2 · Server 2 (server=2) — parameter provider = varian dari /services

Contoh Request
https://sandevanokos.web.id/api/public/v1/order?apikey=API_KEY_ANDA&server=2&country=6&produk=wa&provider=3320
Contoh Respons
{
  "success": true,
  "order": {
    "id": "ORDER_ID",
    "server": "3",
    "country": "6",
    "country_name": "Indonesia",
    "service": "wa",
    "service_name": "WhatsApp",
    "operator": null,
    "number": "6281234567890",
    "otp": null,
    "status": "pending",
    "price": 3500,
    "refunded": false,
    "expires_at": "2026-10-01T10:20:00Z",
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/order— Sandeva Nokos 2 · Server 3 (server=3) — tanpa operator

Contoh Request
https://sandevanokos.web.id/api/public/v1/order?apikey=API_KEY_ANDA&server=3&country=6&produk=wa
Contoh Respons
{
  "success": true,
  "order": {
    "id": "ORDER_ID",
    "server": "3",
    "country": "6",
    "country_name": "Indonesia",
    "service": "wa",
    "service_name": "WhatsApp",
    "operator": null,
    "number": "6281234567890",
    "otp": null,
    "status": "pending",
    "price": 3500,
    "refunded": false,
    "expires_at": "2026-10-01T10:20:00Z",
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/order— Sandeva Nokos 2 · Server 4 (server=4) — negara kode ISO, provider = varian dari /services

Contoh Request
https://sandevanokos.web.id/api/public/v1/order?apikey=API_KEY_ANDA&server=4&country=id&produk=tw&provider=532
Contoh Respons
{
  "success": true,
  "order": {
    "id": "ORDER_ID",
    "server": "3",
    "country": "6",
    "country_name": "Indonesia",
    "service": "wa",
    "service_name": "WhatsApp",
    "operator": null,
    "number": "6281234567890",
    "otp": null,
    "status": "pending",
    "price": 3500,
    "refunded": false,
    "expires_at": "2026-10-01T10:20:00Z",
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/order— Sandeva Nokos 2 · Server 5 (server=6) — negara kode angka

Contoh Request
https://sandevanokos.web.id/api/public/v1/order?apikey=API_KEY_ANDA&server=6&country=6&produk=wa
Contoh Respons
{
  "success": true,
  "order": {
    "id": "ORDER_ID",
    "server": "3",
    "country": "6",
    "country_name": "Indonesia",
    "service": "wa",
    "service_name": "WhatsApp",
    "operator": null,
    "number": "6281234567890",
    "otp": null,
    "status": "pending",
    "price": 3500,
    "refunded": false,
    "expires_at": "2026-10-01T10:20:00Z",
    "created_at": "2026-10-01T10:00:00Z"
  }
}

Isi Saldo (QRIS)

GET/deposit/create— Buat deposit QRIS baru. Bayar tepat sebesar total_payment (sudah termasuk kode unik)

Contoh Request
https://sandevanokos.web.id/api/public/v1/deposit/create?apikey=API_KEY_ANDA&nominal=10000
Contoh Respons
{
  "success": true,
  "deposit": {
    "id": "DEPOSIT_ID",
    "order_id": "SNK1780000000000ABCDE",
    "txn_id": "TRX123",
    "method": "qris",
    "amount": 10000,
    "fee": 86,
    "total_payment": 10086,
    "qr_string": "000201010212...",
    "status": "pending",
    "expired_at": "2026-10-01T10:15:00Z",
    "completed_at": null,
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/deposit/status— Cek status deposit — saldo masuk otomatis saat status completed

Contoh Request
https://sandevanokos.web.id/api/public/v1/deposit/status?apikey=API_KEY_ANDA&id=DEPOSIT_ID
Contoh Respons
{
  "success": true,
  "deposit": {
    "id": "DEPOSIT_ID",
    "order_id": "SNK1780000000000ABCDE",
    "txn_id": "TRX123",
    "method": "qris",
    "amount": 10000,
    "fee": 86,
    "total_payment": 10086,
    "qr_string": "000201010212...",
    "status": "completed",
    "expired_at": "2026-10-01T10:15:00Z",
    "completed_at": null,
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/deposit/cancel— Batalkan deposit yang masih pending

Contoh Request
https://sandevanokos.web.id/api/public/v1/deposit/cancel?apikey=API_KEY_ANDA&id=DEPOSIT_ID
Contoh Respons
{
  "success": true,
  "deposit": {
    "id": "DEPOSIT_ID",
    "order_id": "SNK1780000000000ABCDE",
    "txn_id": "TRX123",
    "method": "qris",
    "amount": 10000,
    "fee": 86,
    "total_payment": 10086,
    "qr_string": "000201010212...",
    "status": "canceled",
    "expired_at": "2026-10-01T10:15:00Z",
    "completed_at": null,
    "created_at": "2026-10-01T10:00:00Z"
  }
}

GET/deposit/history— Riwayat deposit terakhir (opsional status=pending/completed/canceled/expired)

Contoh Request
https://sandevanokos.web.id/api/public/v1/deposit/history?apikey=API_KEY_ANDA&limit=20
Contoh Respons
{
  "success": true,
  "deposits": [ { "id": "DEPOSIT_ID", "amount": 10000, "status": "completed", "...": "..." } ]
}

Alur penggunaan

  1. Ambil negara: /countries?server=…
  2. Ambil layanan & harga: /services?server=…&country=…. Untuk server bervarian, catat nilai provider.
  3. Pesan nomor: /order?server=…&country=…&produk=… (+ provider / operator bila perlu).
  4. Cek OTP tiap 5 detik: /status?id=ORDER_ID sampai status success, canceled, atau expired.
  5. Batalkan bila perlu: /cancel?id=ORDER_ID.

Tidak memakai webhook — cukup cek status secara berkala.

Kode Status

200 Sukses
400 Permintaan salah / saldo tidak cukup / stok habis (lihat field error)
401 API key tidak ada / tidak valid
403 Akun diblokir atau layanan sedang maintenance
404 Order / deposit / endpoint tidak ditemukan
500 Layanan sedang gangguan, coba lagi
Contoh error
{ "success": false, "error": "Saldo tidak cukup." }