Paano Gamitin ang SMM Panel API: API v2 Integration Guide para sa Resellers

Ang SMM panel API ay koneksyon na awtomatikong naglalagay ng orders at tumitingin ng status nito mula sa ibang panel o sa sarili mong software. Gumagamit ang 1PANEL PLUS ng standard SMM panel API v2, kaya kung may code ka nang nakakonekta sa ibang panel, palitan lang ang address at key para kumonekta agad. Parehong services, parehong presyo kada 1,000 at parehong balance ang gamit ng API at ng website.

Sino ang gumagamit ng SMM panel API?

• Resellers: naglilista ng services sa sarili nilang panel at awtomatikong ipinapasa ang orders ng customers
• Agencies: naglalagay ng orders para sa maraming channel nang sabay sa takdang oras
• Developers: gumagawa ng scripts na nag-o-order kapag nagsimula ang stream o may bagong video na na-upload
• Operators: pinagsasama ang balance at order status sa sarili nilang dashboard

Paano makakuha ng API key?

Gumawa nito sa API key screen ng dashboard mo pagkatapos ma-credit ang una mong top up. Isang beses lang ipapakita ang key, sa sandaling gawin mo ito, kaya kopyahin agad at itago sa ligtas na lugar. Kapag gumawa ka ng bagong key, agad nang hindi gagana ang lumang key, kaya kung sa tingin mo ay nalantad ang isang key, gumawa lang ng bago para palitan ito.

Paano magpadala ng API requests?

Ipadala ang bawat request sa POST sa iisang address na https://1panelplus.com/api/v2. Gamitin ang mas gusto mo, form fields (application/x-www-form-urlencoded o multipart) o JSON body (Content-Type: application/json), at isama ang key at action sa bawat request. JSON ang lahat ng response.

Halimbawang request (form fields): key=YOUR_API_KEY&action=balance

Halimbawang request (JSON): {"key": "YOUR_API_KEY", "action": "balance"}

Paano makuha ang service list gamit ang services?

Ipadala ang action=services at makukuha mo ang lahat ng available na service bilang array. Kasama sa bawat service ang service (service ID), name, type, category, rate, min, max, refill at cancel. Ang rate ay presyo kada 1,000 (USD); kapag Package ang type, presyo ito ng isang package. True ang refill para sa services na may refill period, at laging false ang cancel. Magkasamang nasa category ang pangalan ng platform at category, kaya magagaya mo nang buo ang categories sa sarili mong panel.

Halimbawang response: [{"service": SERVICE_ID, "name": "Pangalan ng service", "type": "Default", "category": "YouTube - Pangalan ng category", "rate": "Presyo kada 1,000", "min": "Minimum na dami", "max": "Maximum na dami", "refill": true, "cancel": false}]

Puwedeng magbago ang presyo at services, kaya bilang reseller, magandang kunin ulit ang services sa takdang interval at panatilihing naka-sync ang presyo at min at max na dami sa panel mo.

Paano maglagay ng order gamit ang add?

Ipadala ang action=add kasama ang service (service ID), link (public link) at quantity, at mailalagay ang order at agad ibabawas ang halaga sa balance mo. Ang order sa response ay ang order ID; i-save ito at gamitin para sa status at refill. Puwedeng maglagay ng orders mula sa mga account na na-credit na ang unang top up.

• Regular services: ipadala ang service, link at quantity
• Custom Comments services: ipadala ang comments sa halip na quantity. Isang comment bawat linya, hanggang 500 character bawat linya, at ang bilang ng linya ang dami
• Package services: hindi kailangan ng quantity. Para sa isang package ang order

Halimbawang request: key=YOUR_API_KEY&action=add&service=SERVICE_ID&link=https://www.youtube.com/watch?v=videoid&quantity=1000

Halimbawang response: {"order": ORDER_ID}

Paano tingnan ang order status gamit ang status?

Ipadala ang action=status kasama ang order (isang order ID) para makuha ang status ng order na iyon, o ipadala ang orders na may mga order ID na pinagdugtong ng comma para tingnan ang hanggang 100 nang sabay. Kung marami kang order, malaking tipid sa requests ang pagpapangkat sa mga ito gamit ang orders.

Halimbawang response (isa): {"charge": "Halagang siningil", "start_count": "Start count", "status": "In progress", "remains": "Natitirang dami", "currency": "USD"}

Halimbawang response (marami): {"ORDER_ID_1": {"charge": "...", "start_count": "...", "status": "Completed", "remains": "0", "currency": "USD"}, "ORDER_ID_2": {"error": "Incorrect order ID"}}

Ang charge ay ang binayarang halaga bawas ang anumang na-refund, kaya pagkatapos ng partial o canceled order, makikita mo agad ang halagang talagang nagastos. Awtomatikong nag-a-update ang order status mga bawat minuto, kaya sapat na ang pag-query ng status sa pagitang mga isang minuto.

Paano gamitin ang refill at refill_status?

Ipadala ang action=refill kasama ang order para mag-request ng refill, at makakatanggap ka ng refill (ang refill ID). Tinatanggap ito para sa completed o partially completed orders ng services na may refill period, sa loob ng refill period na binibilang mula sa araw na natapos ang order, kapag walang refill na tumatakbo at lumipas na ang 24 oras mula sa huling request. Ipadala ang action=refill_status kasama ang refill, at sasabihin nito ang status bilang isa sa Pending, In progress, Completed o Rejected.

Halimbawang response: {"refill": REFILL_ID} at {"status": "Completed"}

Pareho ang patakaran sa refill sa website. Nasa Paliwanag sa refill period ang detalyadong kondisyon.

Paano tingnan ang balance gamit ang balance?

Ipadala ang action=balance at makukuha mo ang kasalukuyang balance at currency (USD). Bilang reseller, tingnan ang balance mo bago ipasa ang orders at mag-set up ng alert kapag bumaba ito sa takdang halaga, para tuloy-tuloy ang daloy ng orders mo.

Halimbawang response: {"balance": "Kasalukuyang balance", "currency": "USD"}

Ano ang ibig sabihin ng API error messages?

Bumabalik ang errors bilang JSON na may English na pangungusap sa error field. May takdang sanhi ang bawat pangungusap, kaya puwede itong ikumpara nang direkta ng software mo at asikasuhin.

Puwedeng ibalik ng refill requests ang Refill is not available for this service (walang refill period ang service), Order is not finished yet (hindi pa tapos ang order), Refill period has ended (lumipas na ang refill period), o Refill already requested, try again later (may refill na tumatakbo o hindi pa lumilipas ang 24 oras).

Ilang API request ang puwede kong ipadala?

Hanggang 300 request kada minuto ang kaya ng bawat key. Pangkatin ang status lookups sa tig-100 gamit ang orders at kunin lang ulit ang service list kapag kailangan, at sobra-sobra ang espasyo mo. Halimbawa, kung may 1,000 order na tumatakbo, 10 request isang beses kada minuto ang titingin sa lahat ng ito.

Paano itinatakda ng resellers ang selling price nila?

Ang rate na nakukuha mo sa API ay ang presyo kada 1,000 ng 1PANEL PLUS, at ang resellers mismo ang nagtatakda ng selling price sa sarili nilang panel. Halimbawa, kung magdadagdag ka ng 25% sa service na may rate na $2.00, magbebenta ka sa $2.50 kada 1,000; kapag nag-order ang customer ng 4,000, ang benta mo ay $10.00 at $8.00 ang ibabawas sa 1PANEL PLUS. Halimbawa lang ang mga presyong ito para ipakita ang kuwenta.

Ano ang pagkakasunod sa pag-set up ng API connection?

1. 1Mag-top up ng balance at gumawa ng API key sa dashboard mo
2. 2Tingnan ang key at koneksyon gamit ang balance
3. 3Kunin ang service list gamit ang services at ilista ito sa panel mo
4. 4Magpadala ng isang add sa pinakamaliit na dami at kumuha ng order ID
5. 5Kumpirmahing nagbabago ang status gamit ang status, saka i-on ang awtomatikong pag-order

Nasa API docs ang mga halimbawa sa curl, PHP, Python at Node.js at ang buong paliwanag ng fields, at nasa API group ng FAQ ang iba pang tanong.