Cara Menggunakan API Panel SMM: Panduan Sambungan API v2 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"}

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"}}

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.

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?

1. 1Tambah nilai baki dan buat kunci API di papan pemuka
2. 2Semak kunci dan sambungan dengan balance
3. 3Ambil senarai perkhidmatan dengan services dan senaraikan di panel anda
4. 4Hantar add sekali dengan kuantiti terkecil dan terima nombor pesanan
5. 5Semak 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.