911Proxy OpenAPI
Kunci autentikasi app_key dapat dilihat di halaman beranda pusat pribadi setelah login.
Harap simpan kunci dengan aman, karena kunci memiliki hak administrator akun Anda.
Base URLs:
https://api.911proxy.com
Metode Autentikasi
Autentikasi App Key
Parameter POST:
app_key: {your_app_key}
Atau sebagai parameter query:
?app_key={your_app_key}
Format Respons
Semua interface mengembalikan format JSON yang seragam:
{
"code": 200,
"message": "Operasi berhasil",
"data": {}
}
code: Kode status, 200 menunjukkan sukses, nilai lain menunjukkan kegagalanmessage: Pesan respons (dalam bahasa Mandarin)data: Data respons
Authentication
Interface ini mendukung dua metode autentikasi berikut:
1. Bearer Token (JWT)
Meneruskan Token melalui HTTP Header.
Contoh Header:
Authorization: Bearer <your_jwt_token>
Autentikasi API Key
Interface ini menggunakan metode autentikasi API Key.
Klien perlu menyertakan parameter app_key dalam permintaan, jika tidak, permintaan akan ditolak.
Contoh:
GET /api/example?app_key=your_app_key
POST /api/example?app_key=your_app_key
Content-Type: application/json
Manajemen Akun Proxy
GET Daftar Akun Proxy
GET /api-gate-way/whitelist-account/list
Contoh Respons
Respons Sukses (200)
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"id": 0,
"username": "string",
"password": "string",
"created_at": "string",
"remark": "string",
"product_type": 9,
"usage_flow": 0,
"limit_flow": 102400,
"status": 0
}
]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | responseCode | false | none | Kode status, 200 sukses, 3 app_key tidak valid | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [object] | false | none | none | |
| »»» id | integer | false | none | Nomor akun | |
| »»» username | string | false | none | Nama akun proxy | |
| »»» password | string | false | none | Kata sandi akun proxy | |
| »»» created_at | string | false | none | Waktu penambahan | |
| »»» remark | string | false | none | Catatan | |
| »»» product_type | productTypes | false | none | Tipe paket, 9 Paket Lalu Lintas Residensial Dinamis, 11 IP Residensial Dinamis, 14 IP Pusat Data Statis, 25 IP Residensial Statis | |
| »»» usage_flow | integer | false | none | Lalu lintas yang digunakan, satuan: KB | |
| »»» limit_flow | integer | false | none | Batas lalu lintas kustom: satuan GB maksimal 102400, 0 tidak terbatas | |
| »»» status | integer | false | none | Status aktif: 1 aktif, 0 nonaktif |
Nilai Enumerasi
| Properti | Nilai |
|---|---|
| product_type | 9 |
| product_type | 11 |
| product_type | 14 |
| product_type | 25 |
POST Tambah Akun Proxy
POST /api-gate-way/whitelist-account/add
Parameter Body Permintaan
{
"app_key": "stringstringstringstringstringst",
"accounts": "user01:pass,user02:pass,user03:pass",
"remark": "",
"product_type": 9
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Tidak | none |
| » app_key | body | string | Tidak | Kunci otorisasi |
| » accounts | body | string | Tidak | Akun dan kata sandi, harap isi sesuai format username:password, akun dan kata sandi hanya mendukung angka dan huruf, dilarang memasukkan simbol khusus atau spasi, pisahkan akun dan kata sandi dengan titik dua. Mendukung penambahan batch, pisahkan akun proxy dengan koma bahasa Inggris (,). |
| » remark | body | string | Tidak | Deskripsi akun proxy |
| » product_type | body | productTypes | Tidak | Tipe paket, 9 Paket Lalu Lintas Residensial Dinamis, 11 IP Residensial Dinamis, 14 IP Pusat Data Statis, 25 IP Residensial Statis |
Nilai Enumerasi
| Properti | Nilai |
|---|---|
| » product_type | 9 |
| » product_type | 11 |
| » product_type | 14 |
| » product_type | 25 |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": null
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | null | false | none | none |
POST Hapus Akun Proxy
POST /api-gate-way/whitelist-account/delete
Harap perhatikan bahwa setelah dihapus tidak dapat dipulihkan, lalu lintas yang digunakan dll tidak dapat ditanyakan. Penghapusan memiliki waktu tunggu sekitar 5 menit, selama periode ini masih mungkin terjadi biaya.
Parameter Body Permintaan
{
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Tidak | none |
| » app_key | body | string | Tidak | Kunci otorisasi |
| » accounts | body | string | Tidak | Akun proxy, hanya mendukung angka dan huruf. Mendukung operasi batch, pisahkan akun proxy dengan koma bahasa Inggris (,) |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": null
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | null | false | none | none |
POST Nonaktifkan Akun Proxy
POST /api-gate-way/whitelist-account/disable
Penonaktifan memiliki waktu tunggu sekitar 5 menit, selama periode ini masih mungkin terjadi biaya.
Parameter Body Permintaan
{
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Tidak | none |
| » app_key | body | string | Tidak | Kunci otorisasi |
| » accounts | body | string | Tidak | Akun proxy, hanya mendukung angka dan huruf. Mendukung operasi batch, pisahkan akun proxy dengan koma bahasa Inggris (,) |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": null
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | null | false | none | none |
POST Aktifkan Akun Proxy
POST /api-gate-way/whitelist-account/enable
Parameter Body Permintaan
{
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Tidak | none |
| » app_key | body | string | Tidak | Kunci otorisasi |
| » accounts | body | string | Tidak | Akun proxy, hanya mendukung angka dan huruf. Mendukung operasi batch, pisahkan akun proxy dengan koma bahasa Inggris (,) |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": null
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | null | false | none | none |
POST Ubah Kata Sandi Akun Proxy
POST /api-gate-way/whitelist-account/change-password
Harap perhatikan bahwa setelah diubah ada waktu tunggu 5 menit, selama periode ini kata sandi lama masih mungkin digunakan secara normal.
Parameter Body Permintaan
{
"app_key": "stringstringstringstringstringst",
"account": "user",
"password": "pass"
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Tidak | none |
| » app_key | body | string | Tidak | Kunci otorisasi |
| » account | body | string | Tidak | Akun proxy, hanya mendukung angka dan huruf. |
| » password | body | string | Tidak | Kata sandi baru akun proxy, hanya mendukung angka dan huruf. |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": null
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | null | false | none | none |
POST Ubah Catatan Akun Proxy
POST /api-gate-way/whitelist-account/change-remark
Parameter Body Permintaan
{
"app_key": "stringstringstringstringstringst",
"account": "user",
"remark": ""
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Tidak | none |
| » app_key | body | string | Tidak | Kunci otorisasi |
| » account | body | string | Tidak | Akun proxy, hanya mendukung angka dan huruf. |
| » remark | body | string | Tidak | Catatan baru akun proxy, dalam 32 karakter Mandarin atau 64 karakter Inggris. |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": null
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | null | false | none | none |
POST Ubah Batas Lalu Lintas Akun Proxy
POST /api-gate-way/whitelist-account/change-limit
Harap perhatikan bahwa statistik lalu lintas mungkin memiliki penundaan dalam 5 menit, yaitu konsumsi lalu lintas aktual mungkin melebihi batas ini.
Parameter Body Permintaan
{
"app_key": "stringstringstringstringstringst",
"account": "user",
"limit": 0
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Tidak | none |
| » app_key | body | string | Tidak | Kunci otorisasi |
| » account | body | string | Tidak | Akun proxy, hanya mendukung angka dan huruf. |
| » limit | body | integer | Tidak | Batas lalu lintas, satuan: GB, 0 untuk tidak ada batas |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": null
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | null | false | none | none |
Kueri Log Lalu Lintas
GET Total Lalu Lintas yang Digunakan per Hari
GET /api-gate-way/user-usage-flow/total
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| app_key | query | string(password) | Ya | Kunci autentikasi |
| start_time | query | string(Y-m-d H:i:s) | Tidak | Waktu mulai, dapat akurat hingga detik. Harap perhatikan, pencatatan log memiliki penundaan dalam 5 menit. Default 7 hari terakhir. |
| end_time | query | string(Y-m-d H:i:s) | Tidak | Waktu akhir, dapat akurat hingga detik. Harap perhatikan, pencatatan log memiliki penundaan dalam 5 menit. Default waktu saat ini. |
| username | query | string | Tidak | Nama sub-akun, default kueri semua akun, dapat menentukan sub-akun. Harap perhatikan jika Anda menambahkan sub-akun dengan nama yang sama, kueri ini akan mengembalikan semua catatan penggunaan akun proxy dengan nama yang sama. |
| product_type | query | number | Tidak | Tipe paket |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"day": "2022-08-01",
"flow": 0
}
]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [object] | false | none | none | |
| »»» day | string | false | none | Tanggal | |
| »»» flow | integer | false | none | Konsumsi lalu lintas, satuan KB |
Kueri Paket
GET Daftar Paket yang Dibeli
GET /api-gate-way/user-product/list
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| app_key | query | string(password) | Ya | Kunci autentikasi |
| trade_no | query | string | Tidak | Nomor pesanan, harap masukkan nomor pesanan lengkap. Tidak mendukung pencarian fuzzy. |
| page | query | number | Tidak | Paginasi, default: 1 |
| size | query | number | Tidak | Jumlah tampilan paginasi, default: 20 |
| product_type | query | number | Tidak | Tipe paket |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"id": 0,
"created_at": "2022-05-13 12:14:15",
"expired_at": "2022-05-13 12:14:15",
"product_type": 9,
"trade_no": "2022051312134339861461465434",
"order": {
"created_at": "2022-05-13 12:13:43",
"pay_at": "2022-05-13 12:13:43",
"title": "入门级"
}
}
],
"page": 1,
"page_size": 20,
"total_count": 0,
"total_page": 0
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [object] | false | none | none | |
| »»» id | integer | false | none | Nomor paket | |
| »»» created_at | string | false | none | Waktu efektif paket | |
| »»» expired_at | string | false | none | Waktu kedaluwarsa paket, lalu lintas tidak dapat digunakan setelah kedaluwarsa. | |
| »»» product_type | productTypes | false | none | Tipe paket, 9 Paket Lalu Lintas Residensial Dinamis, 11 IP Residensial Dinamis, 14 IP Pusat Data Statis, 25 IP Residensial Statis | |
| »»» trade_no | string | false | none | Nomor transaksi pesanan | |
| »»» order | object | false | none | none | |
| »»»» created_at | string | false | none | Waktu pembuatan pesanan | |
| »»»» pay_at | string | false | none | Waktu pembayaran pesanan | |
| »»»» title | string | false | none | Deskripsi pesanan | |
| »» page | integer | false | none | Halaman saat ini | |
| »» page_size | integer | false | none | Ukuran halaman | |
| »» total_count | integer | false | none | Total jumlah catatan | |
| »» total_page | integer | false | none | Total jumlah halaman |
Nilai Enumerasi
| Properti | Nilai |
|---|---|
| product_type | 9 |
| product_type | 11 |
| product_type | 14 |
| product_type | 25 |
GET Ringkasan Paket Pengguna
GET /api-gate-way/user-product/summary
Mengambil informasi ringkasan statistik paket pengguna, termasuk total jumlah, jumlah aktif, jumlah yang akan segera kedaluwarsa, jumlah yang telah kedaluwarsa, dan lain-lain.
Parameter Permintaan
| Nama Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| app_key | string(password) | Ya | Kunci autentikasi |
| product_type | integer | Tidak | Jenis produk, hanya mendukung: 9 (Paket Traffic Dinamis), 12 (Paket Traffic IDC Jangka Panjang) |
Respons
{
"code": 200,
"msg": "Berhasil",
"data": {
"total": 1048576,
"total_count": 5,
"effective": 524288,
"effective_count": 3,
"effective_total": 786432,
"effective_used": 262144,
"temporary": 102400,
"temporary_count": 1,
"expired": 51200,
"expired_count": 1,
"used": 473088
}
}
Struktur Data Respons
Kode Status 200
| Field | Tipe | Deskripsi |
|---|---|---|
| total | integer | Total traffic/IP (satuan: KB) |
| total_count | integer | Jumlah total paket |
| effective | integer | Sisa jumlah aktif (satuan: KB) |
| effective_count | integer | Jumlah paket aktif |
| effective_total | integer | Total jumlah aktif (satuan: KB) |
| effective_used | integer | Jumlah yang telah digunakan dalam paket aktif (satuan: KB) |
| temporary | integer | Total jumlah yang akan segera kedaluwarsa (dalam 7 hari, KB) |
| temporary_count | integer | Jumlah paket yang akan segera kedaluwarsa (dalam 7 hari) |
| expired | integer | Sisa jumlah yang telah kedaluwarsa (satuan: KB) |
| expired_count | integer | Jumlah paket yang telah kedaluwarsa |
| used | integer | Total jumlah yang telah digunakan (satuan: KB) |
Ekstraksi IP
GET Ekstrak IP
GET /api-gate-way/ip/v3
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| app_key | query | string(password) | Tidak | Kunci akses |
| cc | query | string | Tidak | Negara atau wilayah |
| state | query | string | Tidak | Provinsi atau negara bagian |
| city | query | string | Tidak | Kota |
| format | query | string | Tidak | Format perolehan |
| lb | query | string | Tidak | Pemisah, hanya berlaku untuk format text |
| num | query | number | Tidak | Jumlah ekstraksi |
| life | query | number | Tidak | Periode pemeliharaan - menit |
| ep | query | string | Tidak | Jaringan proxy |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": {
"list": [
[
"150.109.114.72:1140",
"150.109.114.72:1141",
"150.109.114.72:1142",
"150.109.114.72:1143",
"150.109.114.72:1144",
"150.109.114.72:1145",
"150.109.114.72:1146",
"150.109.114.72:1147",
"150.109.114.72:1148",
"150.109.114.72:1149"
]
]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [any] | false | none | none |
GET Daftar Kota
GET /api-gate-way/ip/dynamic-citys
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"name_zh_cn": "美国",
"name_en": "United States",
"continent_code": "NA",
"country_code": "US",
"items": [
{
"city": null,
"state": null,
"continent_code": null,
"country_code": null
}
]
}
]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [object] | false | none | Daftar | |
| »»» name_zh_cn | string | false | none | Nama negara atau wilayah | |
| »»» name_en | string | false | none | Nama negara atau wilayah | |
| »»» continent_code | string | false | none | Kode benua | |
| »»» country_code | string | false | none | Kode negara atau wilayah | |
| »»» items | [object] | false | none | Provinsi atau negara bagian | |
| »»»» city | string | false | none | Nama kota | |
| »»»» state | string | false | none | Kode nama provinsi atau negara bagian | |
| »»»» continent_code | string | false | none | Kode benua | |
| »»»» country_code | string | false | none | Kode negara atau wilayah |
GET Pencarian Kota
GET /api-gate-way/ip/dynamic-citys/search
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| country_code | query | string | Ya | Kode negara atau wilayah |
| state | query | string | Ya | Kode provinsi atau negara bagian |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": {
"list": ["string"]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [string] | false | none | Daftar |
GET Daftar Provinsi/Negara Bagian
GET /api-gate-way/ip/dynamic-states
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"name_zh_cn": "美国",
"name_en": "United States",
"continent_code": "NA",
"country_code": "US",
"items": [
{
"state": null,
"continent_code": null,
"country_code": null
}
]
}
]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [object] | false | none | Daftar | |
| »»» name_zh_cn | string | false | none | Nama negara atau wilayah | |
| »»» name_en | string | false | none | Nama negara atau wilayah | |
| »»» continent_code | string | false | none | Kode benua | |
| »»» country_code | string | false | none | Kode negara atau wilayah | |
| »»» items | [object] | false | none | Provinsi atau negara bagian | |
| »»»» state | string | false | none | Kode nama provinsi atau negara bagian | |
| »»»» continent_code | string | false | none | Kode benua | |
| »»»» country_code | string | false | none | Kode negara atau wilayah |
GET Pencarian Provinsi/Negara Bagian
GET /api-gate-way/ip/dynamic-states/search
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| country_code | query | string | Ya | Kode negara atau wilayah |
Contoh Respons
200 Response
{
"code": 200,
"msg": "string",
"data": {
"list": ["string"]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Permintaan berhasil | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [string] | false | none | Daftar |
GET Ekstrak Daftar IP Statis yang Dibeli
GET /api-gate-way/ip/get-static-ip
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| country_code | query | string | Tidak | Kode negara atau wilayah |
| product_type | query | number | Tidak | Tipe produk, 25: IP Residensial Statis, 14: IP Pusat Data |
| trade_no | query | string | Tidak | Filter IP melalui nomor pesanan |
| page | query | number | Tidak | Nomor halaman |
| size | query | number | Tidak | Jumlah per halaman |
| status | query | number | Tidak | Status, 1: valid, 2: tidak valid, 3: akan kedaluwarsa, 4: dalam pemeliharaan |
Nilai Enumerasi
| Properti | Nilai |
|---|---|
| product_type | 14 |
| product_type | 25 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
Contoh Respons
200 Response
{}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | none | Inline |
Struktur Data Respons
GET Dapatkan Jumlah IP Statis di Wilayah yang Dijual
GET /api-gate-way/static-ip-region
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| isp | query | string | Tidak | Tipe IP |
Penjelasan Tipe IP
| Tipe IP | Deskripsi |
|---|---|
| 1 | IP Statis Residensial Rumah |
| 0 | IP Statis Pusat Data |
Contoh Respons
200 Response
{
"code": 200,
"msg": "Permintaan berhasil",
"data": {
"list": [
{
"code": "US",
"number": 55
}
]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | none | Inline |
Struktur Data Respons
Kode Status 200
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» list | [object] | false | none | none | |
| »»» code | string | false | none | Kode negara atau wilayah | |
| »»» number | integer | false | none | Jumlah |
Manajemen Pesanan
GET Daftar Pesanan
GET /api-gate-way/order/list
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| page_no | query | integer | Tidak | none |
| page_size | query | integer | Tidak | none |
| trade_no | query | string | Tidak | Nomor pesanan |
| status | query | integer | Tidak | Status pesanan |
| product_type | query | integer | Tidak | Tipe produk |
Penjelasan Detail
status: Status pesanan
| Status | Deskripsi |
|---|---|
| 0 | Menunggu pembayaran |
| 1 | Sudah dibayar |
| 2 | Dibatalkan karena timeout pembayaran |
| 3 | Sudah direfund |
product_type: Tipe produk
| Tipe produk | Deskripsi |
|---|---|
| 3 | Isi ulang saldo |
| 9 | Paket Lalu Lintas Dinamis |
| 11 | Paket Waktu Global Dinamis V2 |
| 12 | Paket Lalu Lintas IDC Jangka Panjang |
| 13 | Paket Lalu Lintas IP Statis Residensial |
| 14 | Paket IP Statis Pusat Data |
| 15 | Paket Lalu Lintas ISP Jangka Panjang |
| 16 | Paket Lalu Lintas Statis |
| 17 | Paket Jumlah IP Dinamis |
| 18 | web-scraper |
| 19 | Perpanjangan IP Statis |
| 20 | Kuota Penggantian IP Statis |
| 21 | Paket Lalu Lintas Statis v2 |
| 24 | Paket Tambahan Lalu Lintas Statis |
| 25 | Paket IP Statis Residensial |
| 26 | Pesanan Tambahan - Beberapa saluran pembayaran memerlukan pengguna mengisi jumlah secara manual, seperti: mata uang virtual, jika terjadi kekurangan pembayaran, perlu menghubungi layanan pelanggan untuk melakukan pembayaran tambahan melalui produk ini |
| 27 | Serp |
| 28 | Video |
Nilai Enumerasi
| Properti | Nilai |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| product_type | 3 |
| product_type | 9 |
| product_type | 11 |
| product_type | 12 |
| product_type | 14 |
| product_type | 16 |
| product_type | 17 |
| product_type | 18 |
| product_type | 19 |
| product_type | 21 |
| product_type | 24 |
| product_type | 25 |
| product_type | 26 |
| product_type | 27 |
| product_type | 28 |
Contoh Respons
200 Response
{
"code": 0,
"message": "Operasi berhasil",
"data": {
"list": [
{
"id": 0,
"trade_no": "string",
"product_id": 0,
"product_name": "string",
"total_fee": 0.1,
"pay_fee": 0.1,
"status": 0,
"created_at": "2019-08-24T14:15:22Z"
}
],
"pagination": {
"total": 0,
"page_no": 0,
"page_size": 0,
"total_pages": 0
}
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Berhasil | Inline |
Struktur Data Respons
POST Buat Pesanan
POST /api-gate-way/order/create
Karena ada banyak jenis paket, dan setiap paket memiliki konfigurasi yang berbeda, harap isi parameter sesuai dengan situasi aktual. Pengisian parameter yang tidak tepat dapat menyebabkan kegagalan pembuatan pesanan.
examples:
Perpanjangan IP Statis
{
"pid": x, // Hubungi layanan pelanggan untuk mendapatkan
"upids": "1,2,3,4,5,6", // Dapatkan ID yang sesuai dari /api-gate-way/ip/get-static-ip
"pm_id": 1 // Dapatkan dari /api-gate-way/payment/list
"coupon_sn: "xxx", // Opsional kupon
}
Parameter Body Permintaan
{
"pid": 0,
"upids": "string",
"amount": 0,
"pm_id": 0,
"region_list": "string",
"coupon_sn": "string",
"use_invitation_registration_discount": true,
"renew_duration": 0,
"product_sku_bandwidth_id": 0,
"product_sku_concurrency_id": 0,
"recharge_amount": 0
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Ya | none |
| » pid | body | integer | Ya | ID paket |
| » upids | body | string | Tidak | Daftar ID paket perpanjangan |
| » amount | body | number | Tidak | Jumlah paket baru |
| » pm_id | body | integer | Ya | ID metode pembayaran |
| » region_list | body | string | Tidak | Tentukan wilayah + jumlah saat membeli IP statis |
| » coupon_sn | body | string | Tidak | Nomor kupon |
| » use_invitation_registration_discount | body | boolean | Tidak | Apakah menggunakan diskon registrasi undangan |
| » renew_duration | body | integer | Tidak | Durasi perpanjangan - opsional untuk IP statis |
| » product_sku_bandwidth_id | body | integer | Tidak | Paket 11: ID paket bandwidth |
| » product_sku_concurrency_id | body | integer | Tidak | Paket 11: ID paket konkurensi |
| » recharge_amount | body | integer | Tidak | Paket 3: Jumlah isi ulang |
Contoh Respons
200 Response
{
"code": 0,
"message": "Operasi berhasil",
"data": {
"id": 0,
"trade_no": "string",
"product_id": 0,
"product_name": "string",
"total_fee": 0.1,
"pay_fee": 0.1,
"status": 0,
"created_at": "2019-08-24T14:15:22Z"
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Pembuatan berhasil | Inline |
Struktur Data Respons
POST Batalkan Pesanan
POST /api-gate-way/order/close
Parameter Body Permintaan
{
"trade_no": "string"
}
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| body | body | object | Ya | none |
| » trade_no | body | string | Ya | none |
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Operasi berhasil | None |
Manajemen Pengguna
GET Dapatkan Informasi Pengguna - Belum Dibuka
GET /api-gate-way/user/info
Contoh Respons
200 Response
{
"code": 0,
"message": "Operasi berhasil",
"data": {
"id": 0,
"email": "[email protected]",
"phone": "string",
"balance": 0.1,
"status": 0,
"is_real_name": true,
"created_at": "2019-08-24T14:15:22Z"
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Berhasil | Inline |
Struktur Data Respons
Manajemen Pembayaran
GET Dapatkan Daftar Metode Pembayaran
GET /api-gate-way/payment/groups
Parameter Permintaan
| Nama | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| trade_no | query | string | Tidak | Nomor pesanan - Dapat dimasukkan saat perlu mendapatkan metode pembayaran khusus untuk pesanan tertentu |
Contoh Respons
200 Response
{
"code": 0,
"message": "Operasi berhasil",
"data": {
"list": [
{
"name": "Grup metode pembayaran",
"logos": ["https://example.com/logo1.png", "https://example.com/logo2.png"],
"items": [
{
"id": 1,
"title": "title1",
"logo": "https://example.com/logo1.png",
"group": "online",
"disabled": false,
"min": 10,
"max": 5000
}
]
}
]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | Perolehan berhasil | Inline |
Struktur Data Respons
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| »» name | string | false | none | Nama grup | |
| »» logos | string[] | false | none | Daftar ikon grup | |
| »» items | object[] | false | none | Daftar item dalam grup | |
| »»» id | integer | false | none | ID metode pembayaran | |
| »»» title | string | false | none | Nama metode pembayaran | |
| »»» logo | string | false | none | Logo metode pembayaran | |
| »»» group | string | false | none | Identitas grup metode pembayaran | |
| »»» disabled | boolean | false | none | Apakah dinonaktifkan (default false) | |
| »»» min | number | false | none | Jumlah minimum | |
| »»» max | number | false | none | Jumlah maksimum |
Pemasaran
GET Rasio Hadiah Isi Ulang
GET /api-gate-way/activity/balance-recharge-gift-ratio
Rasio hadiah isi ulang
Contoh Respons
200 Response
{
"code": 0,
"msg": "Operasi berhasil",
"data": {
"list": [
{
"amount": 100,
"ratio": 1.2
}
]
}
}
Hasil Respons
| Kode Status | Arti Kode Status | Keterangan | Model Data |
|---|---|---|---|
| 200 | OK | OK | Inline |
Struktur Data Respons
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| » code | integer | false | none | Kode status, 200 sukses, 3 app_key tidak valid, 156 akun belum verifikasi nama asli | |
| » msg | string | false | none | Pesan status | |
| » data | object | false | none | none | |
| » list | [object] | false | none | none | |
| »» amount | integer | false | none | Jumlah isi ulang | |
| »» ratio | number | false | none | Rasio isi ulang |
Penjelasan Struktur Data (Schemas)
productTypes (Tipe paket)
| Field | Tipe | Keterangan |
|---|---|---|
| product_type | integer | Tipe paket |
Penjelasan nilai opsional:
| Nilai | Arti |
|---|---|
| 9 | Paket Lalu Lintas Residensial Dinamis |
| 11 | IP Residensial Dinamis |
| 14 | IP Pusat Data Statis |
| 25 | IP Residensial Statis |
API Key (Kunci autentikasi)
Digunakan untuk autentikasi interface, harap kirimkan melalui parameter Query.
| Nama Parameter | Lokasi | Tipe | Wajib Diisi | Keterangan |
|---|---|---|---|---|
| app_key | query | string | Ya | Kunci autentikasi |
Field Respons Umum
responseCode
| Field | Tipe | Contoh | Keterangan |
|---|---|---|---|
| code | integer | 200 | Kode status (200 sukses, 3 menunjukkan app_key tidak valid) |
responseMsg
| Field | Tipe | Contoh | Keterangan |
|---|---|---|---|
| message | string | success | Informasi respons |
Respons Sukses (SuccessResponse)
{
"code": 0,
"message": "Operasi berhasil",
"data": {}
}
Respons Error (ErrorResponse)
{
"code": 400,
"message": "Kesalahan parameter",
"errors": {}
}
User
{
"id": 0,
"email": "[email protected]",
"phone": "string",
"balance": 0.1,
"status": 0,
"is_real_name": true,
"created_at": "2019-08-24T14:15:22Z"
}
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| id | integer | false | none | none | |
| string(email) | false | none | none | ||
| phone | string | false | none | none | |
| balance | number(float) | false | none | none | |
| status | integer | false | none | none | |
| is_real_name | boolean | false | none | none | |
| created_at | string(date-time) | false | none | none |
Order
{
"id": 0,
"trade_no": "string",
"product_id": 0,
"product_name": "string",
"total_fee": 0.1,
"pay_fee": 0.1,
"status": 0,
"created_at": "2019-08-24T14:15:22Z"
}
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| id | integer | false | none | none | |
| trade_no | string | false | none | none | |
| product_id | integer | false | none | none | |
| product_name | string | false | none | none | |
| total_fee | number(float) | false | none | none | |
| pay_fee | number(float) | false | none | none | |
| status | integer | false | none | none | |
| created_at | string(date-time) | false | none | none |
Product
{
"id": 0,
"name": "string",
"type": 0,
"price": 0.1,
"description": "string"
}
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| id | integer | false | none | none | |
| name | string | false | none | none | |
| type | integer | false | none | none | |
| price | number(float) | false | none | none | |
| description | string | false | none | none |
WhiteIp
{
"id": 0,
"ip": "string",
"remark": "string",
"created_at": "2019-08-24T14:15:22Z"
}
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| id | integer | false | none | none | |
| ip | string | false | none | none | |
| remark | string | false | none | none | |
| created_at | string(date-time) | false | none | none |
WhitelistAccount
{
"id": 0,
"username": "string",
"limit": 0,
"used": 0,
"status": 0
}
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| id | integer | false | none | none | |
| username | string | false | none | none | |
| limit | integer | false | none | none | |
| used | integer | false | none | none | |
| status | integer | false | none | none |
Coupon
{
"id": 0,
"name": "string",
"code": "string",
"discount": 0.1,
"expire_time": "2019-08-24T14:15:22Z"
}
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| id | integer | false | none | none | |
| name | string | false | none | none | |
| code | string | false | none | none | |
| discount | number(float) | false | none | none | |
| expire_time | string(date-time) | false | none | none |
Article
{
"id": 0,
"title": "string",
"content": "string",
"created_at": "2019-08-24T14:15:22Z"
}
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| id | integer | false | none | none | |
| title | string | false | none | none | |
| content | string | false | none | none | |
| created_at | string(date-time) | false | none | none |
Pagination
{
"total": 0,
"page_no": 0,
"page_size": 0,
"total_pages": 0
}
| Nama | Tipe | Wajib | Batasan | Nama Mandarin | Keterangan |
|---|---|---|---|---|---|
| total | integer | false | none | none | |
| page_no | integer | false | none | none | |
| page_size | integer | false | none | none | |
| total_pages | integer | false | none | none |