API CEIR — Dokumentasi Integrasi

Kami menyediakan dua mode API untuk menghubungkan layanan CEIR ke sistem Anda. Keduanya memakai saldo & akun yang sama — pilih sesuai kebutuhan:

Mode	API v1 (REST)	API DHRU Fusion (Server)
Cocok untuk	Integrasi langsung: script, bot (WA/Telegram), dashboard, website custom	Website / panel yang sudah memakai DHRU Fusion
Cara pakai	Anda memanggil endpoint kami lewat HTTP	Arahkan panel DHRU ke endpoint kami sebagai API Server
Endpoint	`https://cekceir.org/api/v1/...`	`https://cekceir.org` → `/api/index.php`
Autentikasi	Header `X-Api-Key: <API_KEY>`	`username` + `apiaccesskey` (kredensial DHRU)
Format response	`{"success":true, ...}`	`{"SUCCESS":[...]}` / `{"ERROR":[...]}` + `apiversion`

Pilih API v1 jika Anda membuat integrasi sendiri dari nol (bot, script, atau website custom). Pilih API DHRU Fusion jika Anda punya website/panel yang sudah pakai format DHRU Fusion dan tinggal menyambungkannya ke layanan kami.

Bagian 1 — API v1 (REST)

Integrasikan pengecekan IMEI / CEIR ke website, bot, atau dashboard Anda menggunakan API key.

Base URL: https://cekceir.org/api/v1
Autentikasi: header X-Api-Key: <YOUR_API_KEY> (juga menerima Apikey, api-key, atau query ?api_key=)
Response: JSON (success / data)

Daftar Endpoint

Metode	Endpoint	Keterangan
GET	`/pricing`	Daftar layanan & harga aktif
GET	`/balance`	Cek saldo akun
POST	`/order`	Order tunggal (1 paket + 1 IMEI) & proses CEIR langsung
POST	`/order/bulk`	Order banyak IMEI (1 paket)
GET	`/orders`	Riwayat order (maks. 50)
GET	`/order/{order_id}`	Cek status & hasil satu order

Paket (Layanan)

key	Label	Perlu IMEI
`status`	Cek Status CEIR	1
`history`	Cek History CEIR	1
`bc`	Cek Bea Cukai	1
`digipos`	Cek DigiPOS	1
`smartfren`	Cek Smartfren	1
`validity`	Cek Masa Berlaku	1
`barcode`	Generate Barcode MEID	2 (via `imeis`)

Harga per paket: lihat GET /pricing. Setiap order selalu memotong saldo Anda — baik yang dikirim ke penyedia data maupun yang dibatalkan karena IMEI tidak valid.

Aturan IMEI: Hanya IMEI tepat 15 digit angka yang diteruskan ke penyedia data. IMEI bukan 15 digit (mis. 13, 14, 16 digit) tidak diteruskan ke API penyedia — order langsung dibatalkan (status: cancelled) dengan keterangan, dan saldo tetap terpotong. Pastikan IMEI yang Anda kirim sudah benar.

1. GET /pricing

curl -X GET https://cekceir.org/api/v1/pricing -H "X-Api-Key: YOUR_API_KEY"

Response:

{
  "success": true,
  "data": [
    { "key": "status", "label": "Cek Status CEIR", "short": "Status CEIR", "price": 3500, "price_formatted": "Rp 3.500" }
  ]
}

2. GET /balance

curl -X GET https://cekceir.org/api/v1/balance -H "X-Api-Key: YOUR_API_KEY"

Response:

{ "success": true, "data": { "balance": 100000, "balance_formatted": "Rp 100.000" } }

3. POST /order (tunggal)

curl -X POST https://cekceir.org/api/v1/order \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"package":"status","imei":"351234567890123"}'

Response sukses langsung memuat hasil pengecekan CEIR:

{
  "success": true,
  "message": "Order berhasil diproses.",
  "data": {
    "order_id": "ORD-20260827-XXXXXX",
    "status": "completed",
    "payment_status": "paid",
    "package": "status",
    "package_label": "Cek Status CEIR",
    "imei": "351234567890123",
    "amount": 3500,
    "result": { "status": "registered", "message": "...", "group": "REGISTERED" },
    "raw_data": { ... }
  }
}

Order barcode (2 IMEI)

curl -X POST https://cekceir.org/api/v1/order \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"package":"barcode","imeis":["351234567890123","351234567890124"]}'

4. POST /order/bulk (banyak IMEI)

curl -X POST https://cekceir.org/api/v1/order/bulk \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"package":"status","imeis":["351234567890123","353503759946052"]}'

Maks 50 IMEI per request.
Saldo dipotong per IMEI (total = harga × jumlah IMEI) untuk seluruh batch.
IMEI tepat 15 digit diteruskan ke penyedia data; IMEI bukan 15 digit dibuat order cancelled (tidak diteruskan) — saldo keduanya tetap terpotong.

Response:

{
  "success": true,
  "message": "Bulk order selesai: 2 berhasil, 0 gagal.",
  "data": {
    "request_id": "XXXX",
    "package": "status",
    "total_imeis": 2,
    "completed": 2,
    "failed": 0,
    "total_amount": 7000,
    "orders": [ { "order_id": "...", "imei": "...", "status": "completed", "amount": 3500, "result": "...", "raw_data": "..." } ]
  }
}

5. GET /orders

curl -X GET https://cekceir.org/api/v1/orders -H "X-Api-Key: YOUR_API_KEY"

6. GET /order/{order_id}

curl -X GET https://cekceir.org/api/v1/order/ORD-20260827-XXXXXX -H "X-Api-Key: YOUR_API_KEY"

Kode Error HTTP

Kode	Arti
200	Sukses
401	API key tidak valid / tidak disertakan
402	Saldo tidak mencukupi
404	Order tidak ditemukan
422	Validasi gagal (paket/IMEI tidak valid)
429	Rate limit tercapai (30 request/menit untuk order/bulk)
500	Error sistem
502	Pengecekan upstream gagal

Rate Limit

Endpoint POST /order & POST /order/bulk: 30 request/menit per API key.

Kebutuhan

Konten JSON: selalu sertakan header Accept: application/json.
API key dibuat/dikelola di dashboard member (API Access).

Bagian 2 — API DHRU Fusion (Mode API ke-2)

Selain API v1 (REST) di atas, kami menyediakan API DHRU Fusion — endpoint yang mengikuti standar DHRU Fusion API V6.1. Cocok untuk website / panel yang sudah memakai format DHRU Fusion (reseller unlock/IMEI). Anda tinggal mengarahkan panel DHRU Anda ke endpoint kami, lalu layanan CEIR langsung tampil di panel Anda — tidak perlu menulis kode integrasi dari nol.

Endpoint: POST https://cekceir.org (panel DHRU mode Other Fusion menambahkan /api/index.php otomatis)
⚠️ Disarankan isi API URL = https://cekceir.org — panel DHRU (mode Other Fusion) secara otomatis menambahkan akhiran /api/index.php, sehingga menghasilkan https://cekceir.org/api/index.php yang benar.

Jika https://cekceir.org tidak bekerja di panel Anda, coba urutkan:
1. https://cekceir.org/api
2. https://cekceir.org/api/index.php
Salah satu dari ketiganya yang berhasil disimpan panel adalah yang benar. Endpoint /api/dhru lama telah dihapus dan tidak lagi tersedia.
Autentikasi: username + API access key (kredensial khusus DHRU, terhubung ke saldo akun yang sama)
Response: format JSON DHRU (SUCCESS / ERROR + apiversion)
Cara: atur panel DHRU Anda → Settings → API Settings → Other Fusion → isi API URL, username, dan API Access Key (kredensial DHRU dari dashboard member → API Access).

Kredensial DHRU dibuat / dikelola di dashboard member → API Access → kartu API DHRU Fusion.

Supported Actions

Action	Keterangan
`accountinfo`	Cek saldo & info akun
`imeiservicelist`	Daftar layanan CEIR (SERVICEID, harga, custom field)
`placeimeiorder`	Order 1 IMEI & proses CEIR langsung
`placeimeiorderbulk`	Order banyak IMEI (maks. 50)
`getimeiorder`	Cek status & hasil order
`getimeiorderbulk`	Cek status banyak order (maks. 50)

Pemetaan SERVICEID

SERVICEID	Paket	Label	Perlu IMEI
1	status	Cek Status CEIR	1
2	history	Cek History CEIR	1
3	bc	Cek Bea Cukai	1
4	digipos	Cek DigiPOS	1
5	smartfren	Cek Smartfren	1
6	validity	Cek Masa Berlaku	1
7	barcode	Generate Barcode MEID	2

Menyiapkan di Panel DHRU Anda

Buka Settings → API Settings di panel DHRU Anda.
Pilih slot 'Other Fusion' → Activate → Edit & Sync.
Isi:
- API URL: https://cekceir.org (jika tidak bekerja, coba https://cekceir.org/api lalu https://cekceir.org/api/index.php)
- Username: kredensial DHRU Anda
- API Access Key: kredensial DHRU Anda
Klik Start Sync. Layanan CEIR akan tampil di panel Anda.

Contoh Request

Cek saldo (accountinfo)

curl -X POST https://cekceir.org/api/index.php \
  -d "action=accountinfo" \
  -d "username=USERNAME_DHRU" \
  -d "apiaccesskey=API_ACCESS_KEY"

Response:

{
  "SUCCESS": [
    {
      "message": "Your Account Info",
      "AccoutInfo": {
        "credit": 100000,
        "currency": "IDR",
        "username": "USERNAME_DHRU",
        "mail": "[email protected]"
      }
    }
  ],
  "apiversion": "6.1"
}

Order IMEI (placeimeiorder)

parameters dikirim sebagai string XML (format yang dikirim web DHRU) atau base64-encoded JSON.

curl -X POST https://cekceir.org/api/index.php \
  -d "action=placeimeiorder" \
  -d "username=USERNAME_DHRU" \
  -d "apiaccesskey=API_ACCESS_KEY" \
  -d "parameters=<PARAMETERS><ID>1</ID><IMEI>351234567890123</IMEI></PARAMETERS>"

Response sukses:

{
  "SUCCESS": [
    {
      "MESSAGE": "Order received",
      "REFERENCEID": "DH20260827XXXXXXX",
      "STATUS": 4,
      "CODE": "✅ IMEI 351234567890123 terdaftar RESMI. ..."
    }
  ],
  "apiversion": "6.1"
}

Cek hasil order (getimeiorder)

curl -X POST https://cekceir.org/api/index.php \
  -d "action=getimeiorder" \
  -d "username=USERNAME_DHRU" \
  -d "apiaccesskey=API_ACCESS_KEY" \
  -d "parameters=<PARAMETERS><ID>DH20260827XXXXXXX</ID></PARAMETERS>"

Response:

{
  "SUCCESS": [
    { "STATUS": 4, "CODE": "✅ IMEI 351234567890123 terdaftar RESMI. ..." }
  ],
  "apiversion": "6.1"
}

Kode Status DHRU

Status	Arti
0	New (order baru)
1	In Process
3	Rejected / Cancelled (dipakai untuk IMEI bukan 15 digit)
4	Available (sukses)

Catatan

Setiap placeimeiorder memotong saldo akun Anda sesuai harga paket.
IMEI harus tepat 15 digit angka untuk diteruskan ke penyedia data. IMEI bukan 15 digit → order langsung STATUS 3 (Cancel/Reject) dengan keterangan, tanpa diteruskan ke penyedia dan saldo tetap terpotong.
CODE status cancel, mis: IMEI tidak valid (harus 15 digit). Order dibatalkan: 123.
Untuk paket barcode (SERVICEID 7), kirim 2 IMEI: <IMEI> dan <IMEI2> (atau di custom field).
Rate limit: 30 request/menit per kredensial.

Integrasi API CEIR

API CEIR — Dokumentasi Integrasi

Bagian 1 — API v1 (REST)

Daftar Endpoint

Paket (Layanan)

1. GET /pricing

2. GET /balance

3. POST /order (tunggal)

Order barcode (2 IMEI)

4. POST /order/bulk (banyak IMEI)

5. GET /orders

6. GET /order/{order_id}

Kode Error HTTP

Rate Limit

Kebutuhan

Bagian 2 — API DHRU Fusion (Mode API ke-2)

Supported Actions

Pemetaan SERVICEID

Menyiapkan di Panel DHRU Anda

Contoh Request

Cek saldo (accountinfo)

Order IMEI (placeimeiorder)

Cek hasil order (getimeiorder)

Kode Status DHRU

Catatan