Mwanzo / Wasanidi programu / Orders API
Orders API
Ongeza smm.guide kwenye paneli yako kama mtoa huduma. Kila njia unayounda kwenye akaunti yako ni huduma yenye ID yake: paneli yako hutuma agizo kwa ID hiyo, na njia hulipitisha kwa mtoa huduma wako wa kwanza anayeweza kulipokea.
Hatua tatu
Muundo ni ule ambao paneli za SMM tayari hutumia kati yao, kwa hiyo hakuna cha kuandikia msimbo.
https://smm.guide/api/v2 na ufunguo. Ingiza huduma: njia zako huingia pamoja na ID, bei na vikomo vyake.Muundo wa ombi
| Mbinu ya HTTP | POST |
| URL ya API | https://smm.guide/api/v2 |
| Mwili wa ombi | application/x-www-form-urlencoded, au JSON yenye Content-Type: application/json. A multipart/form-data pia husomwa kama mwili wa ombi, ambao ndio PHP hutuma cURL inapopewa safu (array) |
| Jibu | JSON, daima ikiwa na HTTP 200, hata kwa mwili tusioweza kuusoma au ombi lililo kubwa mno. Hitilafu ni {"error": "…"} |
| Pesa | Dola za Marekani. Bei ni kwa kila 1,000 |
Orodha ya huduma
Njia zako zinazoweza kupokea agizo sasa hivi. Njia iliyozimwa, au ambayo hatua zake zote zimeondolewa, haiorodheshwi.
| Kigezo | Maelezo |
|---|---|
key | Ufunguo wako wa API |
action | services |
Jibu
[
{
"service": 85725095,
"name": "TG views, main",
"type": "Default",
"category": "Telegram views",
"rate": "0.0018",
"min": "10",
"max": "1000000",
"refill": false,
"cancel": true,
"dripfeed": false
}
]rate ni bei ya hatua ghali zaidi ya njia inayoweza kupokea agizo, zikiwemo zilizorukwa kwa sasa (paneli isiyopatikana leo hurudi kesho), kwa hiyo agizo kamwe haligharimu zaidi ya bei ambayo paneli yako iliingiza. min na max ni masafa mapana zaidi ambayo hatua zinazofanya kazi hukubali kwa pamoja; idadi inayotoshea baadhi yake tu huenda kwa mojawapo ya hizo. refill na cancel huwa true kila hatua kama hiyo inapovitoa.
Njia iliyozimwa, au isiyo na hatua inayoweza kufanya kazi, huachwa nje ya orodha hii hadi irudi. Paneli inayosawazisha huduma zake kiotomatiki itazima huduma hiyo upande wake kwa muda huohuo, na hilo ndilo unalotaka: maagizo yake yangekataliwa.
Ongeza agizo
| Kigezo | Maelezo |
|---|---|
key | Ufunguo wako wa API |
action | add |
service | ID ya njia, tarakimu nane |
link | Kiungo cha ukurasa, chapisho au wasifu |
quantity | Idadi inayohitajika |
Jibu
{
"order": 23501
}
Hakuna aliyelikubali
{
"error": "No step of this route accepted the order. …"
}Nambari ya agizo hubaki ileile katika maisha yote ya agizo, bila kujali ni mtoa huduma yupi hatimaye analitekeleza. Njia hupokea kiungo na idadi; utoaji wa taratibu, komenti na sehemu nyingine za ziada hukataliwa.
Hali ya agizo
| Kigezo | Maelezo |
|---|---|
key | Ufunguo wako wa API |
action | status |
order | ID ya agizo |
Jibu
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Kigezo | Maelezo |
|---|---|
key | Ufunguo wako wa API |
action | status |
orders | ID za maagizo zikitenganishwa kwa koma, hadi 100 |
Jibu
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Hali | Maana |
|---|---|
Pending | Limekubaliwa na mtoa huduma na bado halijaanza. Pia agizo ambalo mtoa huduma hakutoa jibu wazi kulihusu: njia husimama hapo hadi uwe umelikagua kwenye akaunti yako. |
In progress, Processing | Mtoa huduma analitekeleza, au agizo liko njiani kwenda hatua inayofuata. |
Completed | Limewasilishwa kikamilifu. |
Partial | Sehemu imewasilishwa; remains ni kile ambacho hakikuwasilishwa. Huhesabu kile ambacho kila hatua iliwasilisha: hatua moja ikiwasilisha sehemu na kilichobaki kikaghairiwa kwenye inayofuata, agizo ni Partial, si Canceled. Mtoa huduma huamua kuhusu kurejesha sehemu iliyobaki ya malipo. |
Canceled | Hakuna kilichowasilishwa, na hakuna hatua nyingine iliyopokea agizo. charge huonyesha kiasi, kama kipo, kilichobaki kimetozwa. |
charge ni kiasi ambacho watoa huduma walitoza kwa agizo hili, kwa dola kwa kiwango cha siku lilipowekwa. start_count hutoka kwa mtoa huduma aliyelianzisha.
Salio
smm.guide haishikilii pesa zako zozote. Takwimu hii ni jumla ya salio lako kwenye paneli zilizo nyuma ya njia zako, kwa dola.
| Kigezo | Maelezo |
|---|---|
key | Ufunguo wako wa API |
action | balance |
Jibu
{
"balance": "126.1375",
"currency": "USD"
}Ghairi
Hupitishwa kwa mtoa huduma aliye na agizo sasa, ikiwa huduma yake inaruhusu kughairi. Agizo unaloghairi kamwe halitumwi kwa hatua inayofuata.
| Kigezo | Maelezo |
|---|---|
key | Ufunguo wako wa API |
action | cancel |
orders | ID za maagizo zikitenganishwa kwa koma, hadi 100 |
Jibu
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Ujazaji upya
Hupitishwa kwa mtoa huduma aliyewasilisha agizo. Ujazaji upya hubeba nambari ya agizo lenyewe.
| Kigezo | Maelezo |
|---|---|
key | Ufunguo wako wa API |
action | refill |
order | ID ya agizo. Au orders: kadhaa, zikitenganishwa kwa koma |
Jibu, agizo moja
{ "refill": "23501" }
Jibu, maagizo kadhaa
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Kigezo | Maelezo |
|---|---|
key | Ufunguo wako wa API |
action | refill_status |
refill | ID ya ujazaji upya. Au refills: kadhaa, zikitenganishwa kwa koma |
Jibu
{ "status": "Completed" }Njia hufanya nini na agizo
- Hatua hujaribiwa kwa mpangilio wako, au ile nafuu zaidi inayofanya kazi kwanza. Unachagua upi katika njia.
- Hatua hurukwa paneli yake isipojibu, salio lake au kikomo chake cha kila siku hakitoshi kwa agizo, idadi iko nje ya inavyokubali, bei yake iko juu ya kikomo ulichoweka, au kwa bei yake agizo lingezidi kikomo cha kila siku cha njia yenyewe. Hurudi yenyewe.
- Hatua huondolewa huduma yake inapoondoka kwenye orodha ya bei, au paneli inapoanza kuuza kitu kingine chini ya ID ileile. Hatua nyingine huendelea kufanya kazi, na unajulishwa.
- Kukataliwa hupeleka agizo mbele. Paneli inapojibu na kukataa, hakuna kilichotozwa, kwa hiyo hatua inayofuata hujaribiwa.
- Kukosa jibu wazi hulisimamisha. Muda kuisha au jibu lililoharibika halionyeshi kama agizo lipo. Kulipitisha mbele kunaweza kulitekeleza na kulitoza mara mbili, kwa hiyo njia husimama na unakagua agizo hilo moja kwenye akaunti yako.
- Agizo moja linaloendelea kwa kila kiungo. Wakati agizo la kiungo fulani linaendelea kwenye njia, agizo la pili la kiungo hichohicho hukataliwa, kama watoa huduma wenyewe wanavyofanya.
- Kughairiwa kabla ya kuwasilishwa kunaweza pia kupeleka agizo mbele, ikiwa umewasha chaguo hilo. Kile ambacho agizo la sehemu halikuwasilisha huenda mbele tu ikiwa uliomba hivyo.
Hitilafu
| Hitilafu | Maana yake |
|---|---|
Invalid API key | Ufunguo si sahihi, umebadilishwa au umebatilishwa. |
This key is limited to certain addresses… | Ombi lilitoka kwenye anwani ambayo haipo kwenye orodha ya ufunguo. |
Incorrect request | Haijulikani action. |
Incorrect service ID | Hakuna njia yako yenye ID hii. Njia uliyoifuta hubaki na nambari yake, na nambari hiyo kamwe haipewi njia nyingine. |
Incorrect order ID | Hakuna agizo lako lenye nambari hii. |
Link is required, Quantity is required | Sehemu ya add haipo au si nambari. |
A route takes a link and a quantity only | Ombi lilikuwa na utoaji wa taratibu, komenti au sehemu nyingine ya ziada. |
This route is switched off | Iwashe kwenye akaunti yako. |
This route already has an order for this link… | Subiri hadi lile linaloendelea likamilike. |
No step of this route can take this order right now. … | Hatua zote zilirukwa kabla ya kutumwa kwa chochote. Maandishi yanataja kila paneli na sababu yake. |
No step of this route accepted the order. … | Kila hatua iliyoombwa ilikataa. Hakuna kilichotozwa. |
Too many requests… | Umezidi kikomo kilicho hapa chini. Subiri dakika moja. |
Mifano
cURL
curl https://smm.guide/api/v2 \ -d key=sgo_… \ -d action=add \ -d service=85725095 \ -d link=https://t.me/channel/123 \ -d quantity=1000
PHP
function smmguide(array $post) {
$ch = curl_init('https://smm.guide/api/v2');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query(
['key' => 'sgo_…'] + $post),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
]);
$out = json_decode(curl_exec($ch), true);
curl_close($ch);
return $out;
}
$order = smmguide(['action' => 'add',
'service' => 85725095,
'link' => 'https://t.me/channel/123',
'quantity' => 1000]);
Ombi la add hujibiwa ndani ya sekunde 30, daima. Njia inaweza kuwauliza watoa huduma kadhaa mmoja baada ya mwingine; kila mmoja hupata muda uliobaki, na mtoa huduma ambaye hangeweza kusubiriwa haulizwi kabisa. Ikiwa wa mwisho aliyeulizwa hajajibu muda unapoisha, unapata nambari ya agizo yenye hali Pending, na njia husimama hapo hadi jibu lijulikane. Maagizo mengi hujibiwa ndani ya sekunde moja au mbili.
Vikomo na usalama
- Maombi 300 kwa dakika kwa kila ufunguo, 120 kati yake yakiwa maagizo. Hadi namba 100 za maagizo kwa wakati mmoja
statusombi. - Ufunguo unaonyeshwa mara moja na huhifadhiwa kama alama bainifu. Wewe wala sisi hatuwezi kuusoma tena. Kuubadilisha huzima ule wa zamani papo hapo.
- Anwani zinazoruhusiwa. Orodhesha anwani ya seva ya paneli yako kwenye akaunti yako na ufunguo hautafanya kazi kutoka mahali pengine popote.
- ID ya njia si siri na haihitaji kuwa siri. Hufanya kazi tu pamoja na ufunguo wa akaunti inayomiliki njia hiyo.
- Vikomo vyako bado vinatumika. Kikomo cha kila siku cha kila paneli, kikomo cha kila siku cha njia yenyewe na agizo lake kubwa zaidi hutumika kwa maagizo yanayofika kupitia API sawasawa na yale unayoweka kwa mkono.
- Pesa kamwe haipiti kupitia smm.guide. Kila agizo hulipwa kutoka kwenye salio lako kwenye paneli inayolipokea. Marejesho na mizozo hubaki kati yako na paneli hiyo.
Unataka kusoma katalogi badala yake?
Paneli, Trust Score na bei za sasa zina API yake, pamoja na seva ya MCP kwa wasaidizi.