Mafunzo ya video, dakika 5:35

Jinsi ya kutumia SMM panel API: mafunzo ya video hatua kwa hatua

Video kwa Kiswahili, pamoja na sura na manukuu kwenye YouTube · English tutorial · Tutoriel en français

API ya Jeskie Panel inaunganisha tovuti, app au SMM panel yako na huduma zetu. Software yako inatuma ombi la POST likiwa na API key yako na action (services, add, status au balance), na panel inajibu kwa JSON. Mafunzo haya yanafuata video sura kwa sura: API key, actions nne, faida yako, oda moja mwanzo hadi mwisho, code iliyo tayari na kuunganisha SMM panel yako na provider.

SMM panel API inafanya nini

SMM panel API inaruhusu software kuweka oda, kufuatilia status yake na kusoma salio lako bila mtu kubofya kwenye tovuti. Badala ya kunakili link ya mteja kwenye panel kwa mkono, tovuti yako inatuma oda mara tu mteja anapolipa, na huduma inaanza kufika yenyewe.

Unachoweza kujenga kwa SMM API

  • Tovuti ya reseller: wateja wanakulipa wewe, na kila oda inakwenda Jeskie Panel yenyewe.
  • SMM panel yako mwenyewe, ikitumia Jeskie Panel kama provider wa followers, likes na views.
  • Bot ya WhatsApp au Telegram, au app ya simu, inayouza huduma ndani ya chat.
  • Dashibodi ya agency inayoweka oda nyingi kila siku kwa ajili ya wateja wake.

API ni bure: kila akaunti ya Jeskie Panel ina key yake, na unalipa oda unazoweka tu, kutoka salio lako, kwa bei ile ile ya tovuti. Unaagiza kwa ajili ya kurasa zako tu? Tovuti na app ya Jeskie SMM ni rahisi zaidi kwako.

Jinsi ya kutumia SMM panel API kwa hatua 5

  1. Fungua akaunti na unakili API key yako. Jisajili kwenye ukurasa wa kujisajili, fungua ukurasa wa Akaunti na unakili API key yako. Hii ni sehemu ya 1 ya video, dakika 0:49.
  2. Pata orodha ya huduma. Tuma action=services: jibu linaonyesha kila huduma iliyo hai pamoja na ID, jina, aina (type), kundi (category), bei (rate), min na max.
  3. Chagua huduma unazouza. Hifadhi ID zake kwenye database yako, pembeni ya bei yako ya kuuza. Sasisha orodha kwa ratiba, si kila mtu anapofungua ukurasa.
  4. Weka oda. Tuma action=add ukiwa na service ID, link ya umma ya mteja na quantity. Panel inajibu kwa order ID: ihifadhi pamoja na oda ya mteja wako.
  5. Fuatilia oda. Tuma action=status ukiwa na order ID na umwonyeshe mteja status. Angalia action=balance kabla ya oda kubwa, ili hakuna oda inayoshindwa kwa kukosa salio.

Kila kitu kinapita kwenye endpoint moja ya POST, /api/v2 kwenye Jeskie Panel, kwa sehemu za fomu na majibu ya JSON. Lugha yoyote inayoweza kutuma ombi la HTTP inafanya kazi: PHP, Python, Node.js, au zana ya no-code inayoita webhook.

Uthibitisho: API key yako kwenye kila ombi

Uthibitisho wa API ya Jeskie Panel ni sehemu moja tu: tuma key yako kama parameter ya key kwenye kila ombi, pamoja na parameter ya action. Hakuna token tofauti, hakuna OAuth, wala kuingia kwanza. Key isiyokuwepo au isiyo sahihi inarudisha {"error": "Invalid API Key."}.

  • Weka key kwenye seva yako, kwenye faili la config au kwenye environment variable.
  • Usiiweke kamwe kwenye ukurasa wa tovuti, kwenye code ya umma au kwenye app ambayo watu wanaipakua: yeyote mwenye key anaweza kutumia salio lako.
  • Ikivuja, tengeneza key mpya kwenye ukurasa wa Akaunti na uibadilishe kila mahali ulipoihifadhi.

Actions nne za API: services, add, status, balance

Sehemu ya 2 ya video, dakika 1:30, inaeleza actions hizi nne. Kila moja ni POST kwenda endpoint ile ile; sehemu za ombi tu ndizo zinabadilika.

ActionUnachotumaUnachopokea
serviceskey, actionKila huduma iliyo hai: ID, jina, type, category, rate, min, max
addkey, action, service, link, quantityOrder ID
add kwa drip feedsehemu za add, pamoja na runs na intervalOrder ID
statuskey, action, ordercharge, start_count, status, remains, currency
balancekey, actionSalio lako na sarafu yake

Parameters za add kwa kila aina ya huduma

Sehemu ya type kwenye orodha ya huduma inakuambia parameters za kutuma pamoja na add:

TypeParameters za add
Defaultservice, link, quantity; runs na interval kwa hiari kwa drip feed
Packageservice, link (kifurushi cha kiasi maalum, bila quantity)
Custom Commentsservice, link, comments (comment moja kwa kila mstari)

Kwa drip feed kwenye huduma ya Default, jumla inayofikishwa ni runs mara quantity, na dakika za interval kati ya kila run. Refill na kusitisha oda bado si actions za API: kwa refill, bonyeza Refill kwenye oda ndani ya akaunti yako, ndani ya kipindi cha refill cha huduma.

Ombi na jibu: JSON inavyoonekana

Ombi ni POST ya kawaida, na body kwa muundo wa application/x-www-form-urlencoded. Baada ya add kufanikiwa, unapokea order ID:

{"order": 23501}

Ombi la status kwa oda hiyo linarudisha kwa mfano:

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

charge ni kiasi kilichokatwa, start_count ni idadi iliyokuwepo huduma ilipoanza, na remains ni quantity ambayo haikufika, ambayo tayari imerudishwa kwenye salio lako status ikiwa Partial.

Kwa nini API inaweza kujibu HTTP 200 ikiwa na error

Kwenye muundo wa SMM panel v2 unaotumiwa na panels nyingi, kukataliwa (salio dogo, service ID isiyo sahihi, link haipo) kunaandikwa ndani ya JSON, kwenye sehemu ya error, kwa mfano {"error": "Incorrect Service ID."}. Kwa hiyo code ya HTTP peke yake haikuambii kama oda imewekwa. Tabia nzuri: soma jibu kila wakati, tafuta error kwanza, kisha usome order au balance.

Faida yako kwa kila oda

rate kwenye orodha ya huduma ni gharama yako kwa kila units 1,000, kwa sarafu ya msingi ya panel, na bei maalum ya akaunti yako ikiwa tayari imewekwa. Wewe unaweka bei yako ya kuuza kwa kila 1,000. Kama rate ni R na unauza kwa S, oda ya 2,000 inakugharimu 2 x R kutoka salio lako, unamtoza mteja 2 x S, na tofauti ni yako.

Jeskie Panel ni provider wa moja kwa moja: hakuna nyongeza ya panel nyingine iliyofichwa ndani ya R, kwa hiyo una nafasi ya kuweka bei nzuri na bado ukapata faida. Linganisha bei yako na rate ya leo kila unaposasisha orodha. Bei za leo kwa TSh ziko kwenye bei za SMM panel Tanzania.

Oda moja, mwanzo hadi mwisho

  1. Mteja wako anachagua huduma kwenye tovuti yako, anabandika link ya umma na anakulipa.
  2. Seva yako inatuma action=add ikiwa na service ID, link na quantity.
  3. Jeskie Panel inajibu kwa order ID; unaihifadhi pembeni ya oda ya mteja.
  4. Seva yako inatuma action=status kila baada ya dakika chache na kuonyesha status kwenye tovuti yako.
  5. Ikifika Completed, oda imekamilika. Ikiwa Partial au Canceled, mrudishie mteja sehemu ambayo haikufika, kwa sababu Jeskie Panel tayari imeirudisha kwenye salio lako.

Code iliyo tayari: PHP, cURL na Python

Video inaonyesha code hii dakika 3:37. Badilisha YOUR_API_KEY kwa key yako, na service ID kwa ID kutoka orodha ya huduma. Kila mfano unaweka oda moja; badilisha action iwe services, status au balance kwa maombi mengine.

PHP

function jeskie_api(array $fields) {
  $ch = curl_init("https://jeskieinc.com/api/v2");
  curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(["key" => "YOUR_API_KEY"] + $fields),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
  ]);
  $reply = json_decode(curl_exec($ch), true);
  curl_close($ch);
  return $reply;
}

$new = jeskie_api(["action" => "add", "service" => 1,
  "link" => "https://instagram.com/jinalako", "quantity" => 1000]);
if (isset($new["error"])) { echo "Oda haikuwekwa: " . $new["error"]; }
else { echo "Order ID: " . $new["order"]; }

cURL

API=https://jeskieinc.com/api/v2
curl -X POST "$API" -d "key=YOUR_API_KEY" -d "action=balance"
curl -X POST "$API" -d "key=YOUR_API_KEY" -d "action=add" \
  -d "service=1" -d "link=https://instagram.com/jinalako" -d "quantity=1000"
curl -X POST "$API" -d "key=YOUR_API_KEY" -d "action=status" -d "order=23501"

Python

import requests

API_URL = "https://jeskieinc.com/api/v2"
API_KEY = "YOUR_API_KEY"

def jeskie_api(**fields):
    reply = requests.post(API_URL, data={"key": API_KEY, **fields}, timeout=30)
    return reply.json()

print(jeskie_api(action="balance"))
order = jeskie_api(action="add", service=1,
                   link="https://instagram.com/jinalako", quantity=1000)
if "error" in order:
    print("Oda haikuwekwa:", order["error"])
else:
    print(jeskie_api(action="status", order=order["order"]))

Client kamili ya PHP inapatikana pia kama faili la mfano kwenye maelezo kamili ya SMM panel API, pamoja na kila parameter na kila jibu. Bot au panel ya Node.js, Go au lugha nyingine inafuata njia ile ile: POST ya fomu, kisha kusoma JSON.

Kufuatilia status ya oda moja au nyingi

StatusMaanaUnachomwonyesha mteja
PendingImepokelewa, inasubiri kuanza"Oda yako iko kwenye foleni"
In progressHuduma imeanza kufika"Huduma imeanza"
ProcessingOda inashughulikiwa"Huduma inaendelea"
CompletedQuantity yote imefika"Imekamilika", pamoja na link ya post
PartialSehemu imefika, iliyobaki imerudishwa kwenye salio lakoMrudishie mteja sehemu ambayo haikufika
CanceledImesitishwa na kurudishwa kwenye salio lakoMrudishie mteja pesa yote

Kwenye Jeskie Panel, action ya status inachukua order ID moja kwa kila ombi. Kufuatilia oda nyingi, weka orodha ya oda ambazo hazijakamilika, ziangalie kila baada ya dakika chache, na uondoe oda kwenye orodha inapofika Completed, Partial au Canceled. Linganisha status bila kujali herufi kubwa au ndogo.

Hakuna kikomo kikali cha maombi, lakini kuuliza mfululizo hakusaidii: hifadhi orodha ya huduma (cache), isasishe mara moja kwa siku, na uache nafasi kati ya maombi ya status. Integration yako inabaki ya haraka na ya kuaminika.

Errors za API na jinsi ya kuzirekebisha

Kila error inakuja kwa JSON yenye sehemu ya error. Ujumbe unabaki kwa Kiingereza, kama code yako inavyoupokea:

Ujumbe wa errorSababuSuluhisho
Invalid API Key.Key haikutambuliwaInakili tena kutoka ukurasa wa Akaunti, bila nafasi
Incorrect request.action au key haikutumwaTuma zote mbili kwenye kila ombi
Incorrect Service ID.service haikutumwa au si sahihiTumia ID kutoka action ya services
Link field is required.Hakuna link iliyotumwaTuma link ya umma
Quantity chini ya min au juu ya maxquantity iko nje ya mipaka ya hudumaIbaki kati ya min na max ya huduma
You don't have sufficient balance to place this order.Salio ni dogo mnoOngeza pesa, kisha tuma oda tena
You cannot start a new order with the same link that is already in progress.Tayari kuna oda inayoendelea kwenye link hiyoSubiri ikamilike, au tumia link nyingine
Incorrect order IDOrder ID haikupatikanaAngalia ID uliyohifadhi

Makosa yanayogharimu pesa

  • Key iliyo wazi. Yeyote mwenye key yako anaweza kutumia salio lako: iweke upande wa seva.
  • Bei za zamani. Rates zinaweza kubadilika. Orodha iliyohifadhiwa kwa wiki nyingi inaweza kukufanya uuze chini ya gharama: isasishe kila siku.
  • Kupuuza errors. Shughulikia kila jibu ambalo si order ID na umwonyeshe mteja ujumbe wazi, badala ya kuchukua pesa bila kufikisha huduma.
  • Oda mbili kwenye link moja. Subiri ya kwanza ikamilike kabla ya kutuma nyingine kwa huduma ile ile.
  • Kusahau kurudisha pesa. Wapelekee wateja wako kiasi cha Partial na Canceled ambacho Jeskie Panel imekurudishia: tiketi za msaada zinabaki chache.

Unganisha SMM panel yako na Jeskie Panel kama provider

Kama tayari una script ya SMM panel, karibu huandiki code yoyote. Hii ni sehemu ya 3 ya video, dakika 4:17. Scripts nyingi zina ukurasa wa mipangilio ya providers au API ambapo unaongeza provider kwa vitu viwili: anwani ya API na key yako.

  1. Ongeza salio dogo. Kwenye Ongeza pesa, lipa kwa M-Pesa, Airtel Money, Mixx by Yas, HaloPesa, kadi au Binance Pay.
  2. Ongeza Jeskie Panel kama provider. Weka API URL iliyo kwenye mifano ya code hapo juu (inaishia na /api/v2) na API key yako.
  3. Leta huduma na uweke bei. Chagua huduma za kuuza na bei yako ya kuuza kwa kila moja.
  4. Jaribu kama mteja. Weka oda ndogo kwenye link unayoimiliki na uangalie inaonekana kwenye historia ya oda zako za Jeskie Panel ikiwa na link na quantity sahihi.
  5. Wafungulie wateja huduma. Anza na oda ndogo, uone huduma inavyofika haraka, kisha fungua huduma nyingine.

Huna script? Fungua child panel kutoka akaunti yako, au kodisha panel iliyo tayari kwenye Jeskie Rental, ikiwa na huduma za Jeskie Panel tayari zimeunganishwa, domain yako na malipo ya ndani yanayokusanywa kwa ajili yako. Kuuza chini ya jina lako, soma SMM panel ya white-label; kwa oda nyingi, angalia SMM panel ya jumla (wholesale).

Kwa nini resellers wa Afrika wanajenga juu ya Jeskie Panel

  • Bei za provider wa moja kwa moja. Seva zetu wenyewe za kufikisha oda, hakuna panel nyingine kati yako na huduma: faida yako inabaki kwako.
  • Ongeza salio kwa njia za nyumbani. Salio lako linapokea mobile money katika nchi 25+ za Afrika, kwa hiyo huhitaji kadi ya dola kulipia oda za API.
  • Rekodi unayoweza kuiona. Oda 500,000+ zimefikishwa tangu Juni 2021, kwa ukadiriaji wa 4.9/5.
  • Muundo ambao panel yako inautarajia. Endpoint moja, actions nne, majibu ya JSON: software nyingi za panel zinaunganika kwa URL na key tu.

Wateja wako wako Tanzania? Nunua followers Tanzania inaonyesha huduma za TikTok, Instagram na YouTube zinazolipwa kwa M-Pesa.

Majibu

Maswali kuhusu SMM panel API

Jinsi ya kutumia API ya SMM panel?

+
Nakili API key yako, tuma action=services uone service IDs, tuma action=add ukiwa na service ID, link ya umma na quantity, kisha action=status ukiwa na order ID. Video inaonyesha kila hatua kwa zaidi kidogo ya dakika tano.

Ninapataje API key yangu ya Jeskie Panel?

+
Ingia, fungua ukurasa wa Akaunti na unakili API key yako. Iweke kwenye seva yako, na utengeneze key mpya kwenye ukurasa huo huo ikivuja.

Uthibitisho wa API unafanyaje kazi?

+
Kwa sehemu moja tu: key yako, inayotumwa kama parameter ya key kwenye kila ombi la POST pamoja na action. Hakuna token tofauti wala OAuth. Key isiyo sahihi inarudisha Invalid API Key.

Kwa nini API inaweza kujibu HTTP 200 ikiwa na error?

+
Kwenye muundo wa SMM panel v2, kukataliwa kunaandikwa ndani ya JSON, kwenye sehemu ya error, si kwenye code ya HTTP. Kwa hiyo soma jibu kila wakati na utafute error kabla ya kusoma order au balance.

Naweza kuangalia status ya oda nyingi kwa wakati mmoja?

+
Kwenye Jeskie Panel, action ya status inachukua order ID moja kwa kila ombi. Weka orodha ya oda ambazo hazijakamilika, ziangalie kila baada ya dakika chache, na uziondoe zikifika Completed, Partial au Canceled.

Je, SMM panel API ni bure?

+
Ndiyo. Kila akaunti ya Jeskie Panel ina API key bila ada ya kuanza wala ya kila mwezi. Unalipa oda unazoweka tu, kutoka salio lako, kwa bei ile ile ya tovuti.

Nahitaji lugha gani ya programu kutumia API?

+
Lugha yoyote inayoweza kutuma ombi la HTTP POST: PHP, Python, Node.js na nyinginezo. Ukurasa huu una mifano iliyo tayari ya PHP, cURL na Python, na scripts nyingi za SMM panel zinaunganika bila code.

Ninaunganishaje SMM panel yangu na Jeskie Panel?

+
Kwenye mipangilio ya providers au API ya panel yako, ongeza provider ukiwa na API URL ya Jeskie Panel na key yako, leta huduma, weka bei zako, kisha weka oda moja ndogo ya kujaribu.

Naweza kuomba refill au kusitisha oda kupitia API?

+
Bado: API inachukua actions za services, add, status na balance. Kwa refill, bonyeza Refill kwenye oda ndani ya akaunti yako ndani ya kipindi cha refill. Kwa jambo jingine, wasiliana na timu ya msaada ukiwa na order ID.

Nini kinatokea oda ikiwa Partial?

+
Sehemu tu ya oda imefika, na Jeskie Panel inarudisha sehemu ambayo haikufika kwenye salio lako yenyewe. Jibu la status lina remains: mrudishie mteja wako sehemu hiyo hiyo.

Ninawezaje kuanzisha SMM panel yangu mwenyewe?

+
Weka script ya SMM panel na uongeze Jeskie Panel kama provider kwa API, fungua child panel kutoka akaunti yako ya Jeskie Panel, au kodisha panel iliyo tayari kwenye Jeskie Rental, huduma zikiwa tayari zimeunganishwa.

Ninalipaje oda za API nikiwa Tanzania?

+
Zinakatwa kutoka salio lako la Jeskie Panel. Ongeza pesa kwa M-Pesa, Airtel Money, Mixx by Yas, HaloPesa, kadi au Binance Pay. Bei za leo kwa TSh ziko kwenye bei za SMM panel Tanzania.

Weka oda yako ya kwanza kwa API leo

Fungua akaunti, ongeza salio kwa M-Pesa na unakili key yako kwenye ukurasa wa Akaunti. Anza na oda ndogo, uone huduma inavyofika haraka, kisha acha tovuti au panel yako iagize yenyewe.

Endelea

Zaidi kuhusu SMM panel API