Kreu / Zhvilluesit / Orders API
Orders API
Shtojeni smm.guide në panelin tuaj si furnizues. Çdo rrugë që krijoni në llogarinë tuaj është një shërbim me ID-në e vet: paneli juaj i dërgon një porosi asaj ID-je dhe rruga ia kalon te i pari nga furnizuesit tuaj që mund ta marrë.
Tre hapa
Formati është ai që panelet SMM përdorin tashmë mes tyre, ndaj nuk ka asgjë për të programuar.
https://smm.guide/api/v2 dhe çelësin. Importoni shërbimet: rrugët tuaja vijnë me ID-të, çmimet dhe kufijtë e tyre.Formati i kërkesës
| Metoda HTTP | POST |
| URL-ja e API-së | https://smm.guide/api/v2 |
| Trupi | application/x-www-form-urlencoded, ose JSON me Content-Type: application/json. A multipart/form-data si trup lexohet gjithashtu, që është ajo që dërgon PHP kur cURL-it i jepet një array |
| Përgjigjja | JSON, gjithmonë me HTTP 200, edhe për një trup që nuk mund ta lexojmë ose një kërkesë shumë të madhe. Një gabim është {"error": "…"} |
| Paratë | Dollarë amerikanë. Çmimet janë për 1 000 |
Lista e shërbimeve
Rrugët tuaja që mund të marrin porosi tani. Një rrugë e çaktivizuar ose që i ka të gjithë hapat jashtë nuk listohet.
| Parametri | Përshkrimi |
|---|---|
key | Çelësi juaj API |
action | services |
Përgjigjja
[
{
"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 është më i shtrenjti nga hapat e rrugës që mund ta marrin porosinë, përfshirë ata të anashkaluar për momentin (një panel që sot nuk funksionon rikthehet nesër), ndaj një porosi nuk kushton kurrë më shumë se çmimi që importoi paneli juaj. min dhe max janë kufijtë më të gjerë që mbulojnë së bashku hapat funksionalë; një sasi që u përshtatet vetëm disa prej tyre shkon te njëri prej atyre. refill dhe cancel janë true kur çdo hap i tillë i ofron.
Një rrugë e çaktivizuar ose pa asnjë hap që mund të funksionojë mbetet jashtë kësaj liste derisa të rikthehet. Një panel që i sinkronizon shërbimet automatikisht do ta çaktivizojë atë shërbim nga ana e vet për të njëjtën kohë, dhe kjo është ajo që doni: porositë e tij do të refuzoheshin.
Shtoni porosi
| Parametri | Përshkrimi |
|---|---|
key | Çelësi juaj API |
action | add |
service | ID-ja e rrugës, tetë shifra |
link | Lidhja drejt faqes, postimit ose profilit |
quantity | Sasia e nevojshme |
Përgjigjja
{
"order": 23501
}
Askush nuk e pranoi
{
"error": "No step of this route accepted the order. …"
}Numri i porosisë mbetet i njëjtë gjatë gjithë jetës së porosisë, cilido furnizues ta dorëzojë në fund. Një rrugë merr një lidhje dhe një sasi; dërgimi gradual, komentet dhe fushat e tjera shtesë refuzohen.
Statusi i porosisë
| Parametri | Përshkrimi |
|---|---|
key | Çelësi juaj API |
action | status |
order | ID-ja e porosisë |
Përgjigjja
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametri | Përshkrimi |
|---|---|
key | Çelësi juaj API |
action | status |
orders | ID-të e porosive të ndara me presje, deri në 100 |
Përgjigjja
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Statusi | Kuptimi |
|---|---|
Pending | E pranuar nga një furnizues dhe ende e panisur. Gjithashtu një porosi për të cilën furnizuesi nuk dha përgjigje të qartë: rruga ndalet aty derisa ta keni kontrolluar në llogarinë tuaj. |
In progress, Processing | Një furnizues po e dorëzon ose porosia është rrugës për te hapi tjetër. |
Completed | Dorëzuar plotësisht. |
Partial | Dorëzuar pjesërisht; remains është ajo që nuk u dorëzua. Llogaritet ajo që dorëzoi çdo hap: kur një hap dorëzoi një pjesë dhe pjesa tjetër u anulua te hapi pasardhës, porosia është Partial, jo Canceled. Për kthimin e pjesës tjetër të tarifës vendos furnizuesi. |
Canceled | Nuk u dorëzua asgjë dhe asnjë hap tjetër nuk e mori porosinë. charge tregon çfarë mbeti e tarifuar, nëse mbeti diçka. |
charge është ajo që tarifuan furnizuesit për këtë porosi, në dollarë me kursin e ditës kur u bë. start_count vjen nga furnizuesi që e nisi.
Bilanci
smm.guide nuk mban asnjë para tuajën. Shifra është shuma e bilanceve tuaja në panelet pas rrugëve tuaja, në dollarë.
| Parametri | Përshkrimi |
|---|---|
key | Çelësi juaj API |
action | balance |
Përgjigjja
{
"balance": "126.1375",
"currency": "USD"
}Anuloni
I kalohet furnizuesit që e mban porosinë tani, nëse shërbimi i tij ofron anulim. Një porosi që e anuloni nuk i dërgohet kurrë hapit tjetër.
| Parametri | Përshkrimi |
|---|---|
key | Çelësi juaj API |
action | cancel |
orders | ID-të e porosive të ndara me presje, deri në 100 |
Përgjigjja
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Rimbushja
I kalohet furnizuesit që e dorëzoi porosinë. Rimbushja mban numrin e vetë porosisë.
| Parametri | Përshkrimi |
|---|---|
key | Çelësi juaj API |
action | refill |
order | ID-ja e porosisë. Ose orders: disa, të ndara me presje |
Përgjigjja, një porosi
{ "refill": "23501" }
Përgjigjja, disa
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parametri | Përshkrimi |
|---|---|
key | Çelësi juaj API |
action | refill_status |
refill | ID-ja e rimbushjes. Ose refills: disa, të ndara me presje |
Përgjigjja
{ "status": "Completed" }Çfarë bën një rrugë me një porosi
- Hapat provohen sipas radhës suaj ose së pari ai funksional më i lirë. Ju zgjidhni cilën mënyrë në rrugë.
- Një hap anashkalohet kur paneli i tij nuk përgjigjet, bilanci ose kufiri i tij ditor nuk e mbulon porosinë, sasia është jashtë asaj që pranon, çmimi i tij është mbi kufirin që keni vendosur, ose me çmimin e tij porosia do ta kalonte kufirin ditor të vetë rrugës. Rikthehet vetë.
- Një hap del jashtë kur shërbimi i tij largohet nga lista e çmimeve ose paneli nis të shesë diçka tjetër me të njëjtën ID. Hapat e tjerë vazhdojnë të funksionojnë dhe ju njoftoheni.
- Një refuzim e kalon porosinë më tej. Kur një panel përgjigjet dhe refuzon, nuk është tarifuar asgjë, ndaj provohet hapi tjetër.
- Mungesa e përgjigjes së qartë e ndal. Një skadim kohe ose një përgjigje e prishur nuk tregon nëse porosia ekziston. Kalimi i saj më tej mund ta dorëzonte dhe ta tarifonte dy herë, ndaj rruga ndalet dhe ju e kontrolloni atë porosi në llogarinë tuaj.
- Një porosi aktive për lidhje. Ndërsa një porosi për një lidhje është në ekzekutim në një rrugë, një e dytë për të njëjtën lidhje refuzohet, ashtu siç bëjnë vetë furnizuesit.
- Edhe një anulim para dorëzimit mund të kalojë më tej, nëse e keni aktivizuar këtë. Ajo që një porosi e pjesshme la pa dorëzuar kalon më tej vetëm nëse e keni kërkuar.
Gabimet
| Gabimi | Çfarë do të thotë |
|---|---|
Invalid API key | Çelësi është i gabuar, i zëvendësuar ose i shfuqizuar. |
This key is limited to certain addresses… | Kërkesa erdhi nga një adresë që nuk është në listën e çelësit. |
Incorrect request | E panjohur action. |
Incorrect service ID | Asnjë rrugë e juaja nuk e ka këtë ID. Një rrugë e fshirë e ruan numrin e saj dhe ai nuk i jepet kurrë një tjetre. |
Incorrect order ID | Asnjë porosi e juaja nuk e ka këtë numër. |
Link is required, Quantity is required | Një fushë e add mungon ose nuk është numër. |
A route takes a link and a quantity only | Kërkesa përmbante dërgim gradual, komente ose një fushë tjetër shtesë. |
This route is switched off | Aktivizojeni në llogarinë tuaj. |
This route already has an order for this link… | Prisni derisa të përfundojë ajo që është në ekzekutim. |
No step of this route can take this order right now. … | Çdo hap u anashkalua para se të dërgohej diçka. Teksti emërton çdo panel dhe arsyen e tij. |
No step of this route accepted the order. … | Çdo hap që u pyet refuzoi. Nuk u tarifua asgjë. |
Too many requests… | Mbi kufirin më poshtë. Prisni një minutë. |
Shembuj
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]);
Thirrja add merr gjithmonë përgjigje brenda 30 sekondave. Një rrugë mund të pyesë disa furnizues njëri pas tjetrit; secili merr atë që ka mbetur nga kjo kohë dhe një furnizues që nuk mund të pritej nuk pyetet fare. Nëse i fundit i pyetur nuk është përgjigjur kur mbaron koha, merrni një numër porosie me statusin Pending dhe rruga ndalet aty derisa të dihet përgjigjja. Shumica e porosive marrin përgjigje brenda një ose dy sekondave.
Kufijtë dhe siguria
- 300 kërkesa në minutë për çelës, nga të cilat 120 porosi. Deri në 100 ID porosish në një
statusthirrje. - Çelësi shfaqet një herë dhe ruhet si gjurmë. As ju, as ne nuk mund ta lexojmë përsëri. Zëvendësimi e çaktivizon menjëherë të vjetrin.
- Adresat e lejuara. Shënoni adresën e serverit të panelit tuaj në llogarinë tuaj dhe çelësi nuk funksionon nga askund tjetër.
- ID-ja e rrugës nuk është sekret dhe nuk ka nevojë të jetë. Funksionon vetëm bashkë me çelësin e llogarisë që zotëron rrugën.
- Kufijtë tuaj vazhdojnë të vlejnë. Kufiri ditor i çdo paneli, kufiri ditor i vetë rrugës dhe porosia e saj më e madhe zbatohen për porositë që vijnë përmes API-së njësoj si për ato që bëni me dorë.
- Paratë nuk kalojnë kurrë përmes smm.guide. Çdo porosi paguhet nga bilanci juaj në panelin që e merr. Rimbursimet dhe mosmarrëveshjet mbeten mes jush dhe atij paneli.
Doni të lexoni katalogun?
Panelet, Trust Score dhe çmimet e drejtpërdrejta kanë API-në e tyre dhe një server MCP për asistentët.