Ringkasan utama
Cara permintaan, 6 action, contoh respons, mesej ralat dan had permintaan API v2 panel SMM standard, dirumuskan untuk penjual semula.
API panel SMM ialah cara sambungan untuk membuat pesanan dan menyemak status secara automatik dari panel lain atau program yang anda bina sendiri. 1PANEL PLUS menggunakan API v2 panel SMM standard, jadi jika anda sudah mempunyai kod yang disambungkan ke panel lain, anda hanya perlu menukar alamat dan kunci untuk terus menyambung. API dan laman web menggunakan perkhidmatan yang sama, harga setiap 1,000 yang sama dan baki yang sama.
Siapakah yang menggunakan API panel SMM?
- Penjual semula: menyenaraikan perkhidmatan di panel sendiri dan menghantar pesanan pelanggan secara automatik
- Agensi: membuat pesanan untuk banyak saluran sekali gus pada masa yang ditetapkan
- Pembangun: membina skrip yang memesan mengikut permulaan siaran atau muat naik video baharu
- Pengendali: mengumpulkan baki dan status pesanan dalam skrin pengurusan sendiri
Bagaimanakah cara mendapatkan kunci API?
Buat di skrin Kunci API pada papan pemuka selepas tambah nilai pertama anda dimasukkan. Kunci hanya dipaparkan sekali semasa dibuat, jadi salin dengan segera dan simpan di tempat yang selamat. Apabila anda membuat kunci baharu, kunci lama terus tidak boleh digunakan, jadi jika anda fikir kunci telah terdedah, buat kunci baharu untuk menggantikannya.
Bagaimanakah cara menghantar permintaan API?
Semua permintaan dihantar melalui POST ke satu alamat, https://1panelplus.com/api/v2. Gunakan sama ada medan borang (application/x-www-form-urlencoded atau multipart) atau badan JSON (Content-Type: application/json), mana yang lebih mudah, dan sertakan key dan action dalam setiap permintaan. Semua respons dalam JSON.
Contoh permintaan (medan borang): key=YOUR_API_KEY&action=balance
Contoh permintaan (JSON): {"key": "YOUR_API_KEY", "action": "balance"}
| action | Nilai yang dihantar bersama | Nilai yang dikembalikan |
|---|---|---|
| services | Tiada | Senarai perkhidmatan |
| add | service, link, quantity atau comments | order (nombor pesanan) |
| status | satu order atau orders (sehingga 100, dipisahkan koma) | charge, start_count, status, remains, currency |
| refill | order | refill (nombor refill) |
| refill_status | refill | status |
| balance | Tiada | balance, currency |
- action
- services
- Nilai yang dihantar bersama
- Tiada
- Nilai yang dikembalikan
- Senarai perkhidmatan
- action
- add
- Nilai yang dihantar bersama
- service, link, quantity atau comments
- Nilai yang dikembalikan
- order (nombor pesanan)
- action
- status
- Nilai yang dihantar bersama
- satu order atau orders (sehingga 100, dipisahkan koma)
- Nilai yang dikembalikan
- charge, start_count, status, remains, currency
- action
- refill
- Nilai yang dihantar bersama
- order
- Nilai yang dikembalikan
- refill (nombor refill)
- action
- refill_status
- Nilai yang dihantar bersama
- refill
- Nilai yang dikembalikan
- status
- action
- balance
- Nilai yang dihantar bersama
- Tiada
- Nilai yang dikembalikan
- balance, currency
Bagaimanakah cara mendapatkan senarai perkhidmatan dengan services?
Hantar action=services dan semua perkhidmatan yang dijual dikembalikan sebagai tatasusunan. Setiap perkhidmatan mengandungi service (nombor perkhidmatan), name, type, category, rate, min, max, refill dan cancel. rate ialah harga setiap 1,000 (USD), dan jika type ialah Package, ia ialah harga satu pakej. refill bernilai true bagi perkhidmatan yang mempunyai tempoh refill, dan cancel sentiasa false. category mengandungi nama platform bersama kategori, jadi anda boleh membina kategori panel sendiri seperti asal.
Contoh respons: [{"service": SERVICE_ID, "name": "Nama perkhidmatan", "type": "Default", "category": "YouTube - Nama kategori", "rate": "Harga setiap 1,000", "min": "Kuantiti minimum", "max": "Kuantiti maksimum", "refill": true, "cancel": false}]
Harga dan perkhidmatan boleh berubah, jadi jika anda penjual semula, ambil semula services pada selang masa tetap untuk menyelaraskan harga serta kuantiti minimum dan maksimum di panel anda.
Bagaimanakah cara membuat pesanan dengan add?
Hantar action=add bersama service (nombor perkhidmatan), link (pautan awam) dan quantity (kuantiti), dan pesanan diterima serta jumlahnya terus ditolak daripada baki. order dalam respons ialah nombor pesanan, jadi simpan nombor ini untuk digunakan dengan status dan refill. Pesanan boleh dibuat dari akaun yang tambah nilai pertamanya telah dimasukkan.
- Perkhidmatan biasa: hantar service, link dan quantity
- Perkhidmatan Custom Comments: hantar comments sebagai ganti quantity. Satu komen setiap baris, sehingga 500 aksara setiap baris, dan bilangan baris ialah kuantiti
- Perkhidmatan Package: kuantiti tidak perlu dihantar. Ia dipesan sebagai satu pakej
Contoh permintaan: key=YOUR_API_KEY&action=add&service=SERVICE_ID&link=https://www.youtube.com/watch?v=videoid&quantity=1000
Contoh respons: {"order": ORDER_ID}
Bagaimanakah cara menyemak status pesanan dengan status?
Hantar action=status dengan order (satu nombor pesanan) untuk mendapatkan status pesanan tersebut, atau hantar orders dengan nombor pesanan dipisahkan koma untuk menyemak sehingga 100 sekali gus. Jika anda mengurus banyak pesanan, menyemak secara berkumpulan dengan orders sangat menjimatkan bilangan permintaan.
Contoh respons (satu): {"charge": "Jumlah dicaj", "start_count": "Angka permulaan", "status": "In progress", "remains": "Kuantiti berbaki", "currency": "USD"}
Contoh respons (beberapa): {"ORDER_ID_1": {"charge": "...", "start_count": "...", "status": "Completed", "remains": "0", "currency": "USD"}, "ORDER_ID_2": {"error": "Incorrect order ID"}}
| Nilai status | Maksud |
|---|---|
| Pending | Diterima dan menunggu untuk bermula atau sedang dipindahkan ke pemprosesan |
| In progress | Sedang dihantar |
| Completed | Dihantar sepenuhnya |
| Partial | Sebahagian dihantar dan baki jumlah dikembalikan ke baki |
| Canceled | Tidak dapat diproses dan jumlah penuh dikembalikan ke baki |
- Nilai status
- Pending
- Maksud
- Diterima dan menunggu untuk bermula atau sedang dipindahkan ke pemprosesan
- Nilai status
- In progress
- Maksud
- Sedang dihantar
- Nilai status
- Completed
- Maksud
- Dihantar sepenuhnya
- Nilai status
- Partial
- Maksud
- Sebahagian dihantar dan baki jumlah dikembalikan ke baki
- Nilai status
- Canceled
- Maksud
- Tidak dapat diproses dan jumlah penuh dikembalikan ke baki
charge ialah jumlah dibayar ditolak jumlah yang dikembalikan, jadi selepas Separa atau Dibatalkan, jumlah yang benar-benar digunakan terus kelihatan. Status pesanan dikemas kini secara automatik kira-kira setiap 1 minit, jadi menyemak status pada selang sekitar 1 minit sudah memadai.
Bagaimanakah cara menggunakan refill dan refill_status?
Hantar action=refill dengan order untuk meminta refill, dan refill (nombor refill) dikembalikan. Ia diterima bagi pesanan Selesai atau Separa untuk perkhidmatan yang mempunyai tempoh refill, dalam tempoh refill yang dikira dari hari pesanan tamat, apabila tiada refill yang sedang berjalan dan 24 jam telah berlalu sejak permintaan terakhir. Hantar action=refill_status dengan refill dan ia memberitahu status sebagai salah satu daripada Pending, In progress, Completed atau Rejected.
Contoh respons: {"refill": REFILL_ID} dan {"status": "Completed"}
Peraturan refill sama seperti di laman web. Syarat terperinci dirumuskan dalam Penerangan tempoh refill.
Bagaimanakah cara menyemak baki dengan balance?
Hantar action=balance dan baki semasa serta mata wang (USD) dikembalikan. Jika anda penjual semula, semak baki sebelum menghantar pesanan dan tetapkan notifikasi apabila baki jatuh di bawah jumlah tertentu supaya pesanan berterusan tanpa gangguan.
Contoh respons: {"balance": "Baki semasa", "currency": "USD"}
Apakah maksud mesej ralat API?
Ralat dikembalikan sebagai JSON dengan ayat bahasa Inggeris dalam medan error. Setiap ayat mempunyai punca yang tetap, jadi program anda boleh membandingkan dan mengendalikannya seperti sedia ada.
| Nilai error | Maksud |
|---|---|
| Invalid API key | Kunci tiada atau tidak sah |
| Too many requests | Melebihi had permintaan seminit. Hantar semula sebentar lagi |
| Add funds first | Pesanan boleh dibuat selepas tambah nilai pertama dimasukkan |
| Incorrect service ID | Bukan nombor perkhidmatan yang dijual |
| Incorrect link | Format pautan tidak sah |
| Quantity out of range | Kuantiti di luar julat minimum dan maksimum perkhidmatan |
| Incorrect comments | Baris komen kosong atau satu baris melebihi 500 aksara |
| Not enough funds on balance | Baki kurang daripada jumlah pesanan |
| Incorrect order ID | Bukan nombor pesanan akaun ini |
| Incorrect refill ID | Bukan nombor refill akaun ini |
| Incorrect action | Nilai action bukan salah satu daripada 6 pilihan |
- Nilai error
- Invalid API key
- Maksud
- Kunci tiada atau tidak sah
- Nilai error
- Too many requests
- Maksud
- Melebihi had permintaan seminit. Hantar semula sebentar lagi
- Nilai error
- Add funds first
- Maksud
- Pesanan boleh dibuat selepas tambah nilai pertama dimasukkan
- Nilai error
- Incorrect service ID
- Maksud
- Bukan nombor perkhidmatan yang dijual
- Nilai error
- Incorrect link
- Maksud
- Format pautan tidak sah
- Nilai error
- Quantity out of range
- Maksud
- Kuantiti di luar julat minimum dan maksimum perkhidmatan
- Nilai error
- Incorrect comments
- Maksud
- Baris komen kosong atau satu baris melebihi 500 aksara
- Nilai error
- Not enough funds on balance
- Maksud
- Baki kurang daripada jumlah pesanan
- Nilai error
- Incorrect order ID
- Maksud
- Bukan nombor pesanan akaun ini
- Nilai error
- Incorrect refill ID
- Maksud
- Bukan nombor refill akaun ini
- Nilai error
- Incorrect action
- Maksud
- Nilai action bukan salah satu daripada 6 pilihan
Bagi permintaan refill, anda mungkin menerima Refill is not available for this service (perkhidmatan tanpa tempoh refill), Order is not finished yet (pesanan belum tamat), Refill period has ended (tempoh refill telah tamat) atau Refill already requested, try again later (terdapat refill yang sedang berjalan atau 24 jam belum berlalu).
Berapa banyak permintaan API yang boleh dihantar?
Setiap kunci boleh membuat sehingga 300 permintaan seminit. Kumpulkan semakan status sebanyak 100 setiap kali dengan orders, dan ambil semula senarai perkhidmatan hanya apabila perlu, maka had ini amat mencukupi. Contohnya, jika terdapat 1,000 pesanan yang sedang berjalan, anda boleh menyemak kesemuanya dengan 10 permintaan sekali seminit.
Bagaimanakah penjual semula menetapkan harga jualan?
rate yang diterima melalui API ialah harga setiap 1,000 1PANEL PLUS, dan harga jualan di panel anda ditetapkan sendiri oleh penjual semula. Contohnya, jika anda menjual perkhidmatan dengan rate $2.00 dengan tambahan 25%, ia menjadi $2.50 setiap 1,000, dan jika pelanggan memesan 4,000, jumlah jualan ialah $10.00 manakala jumlah yang ditolak di 1PANEL PLUS ialah $8.00. Harga ini ialah contoh untuk menunjukkan pengiraan.
Apakah urutan terbaik untuk menyambungkan API?
- Tambah nilai baki dan buat kunci API di papan pemuka
- Semak kunci dan sambungan dengan balance
- Ambil senarai perkhidmatan dengan services dan senaraikan di panel anda
- Hantar add sekali dengan kuantiti terkecil dan terima nombor pesanan
- Semak sama ada status berubah dengan status, kemudian aktifkan pesanan automatik
Contoh curl, PHP, Python dan Node.js serta keterangan penuh medan terdapat dalam Dokumentasi API, dan soalan lain boleh dilihat dalam kumpulan API di Soalan Lazim.