Acasă / Dezvoltatori / Orders API
Orders API
Adăugați smm.guide în panoul dvs. ca furnizor. Fiecare rută creată în contul dvs. este un serviciu cu propriul ID: panoul trimite o comandă la acel ID, iar ruta o transmite primului dintre furnizorii dvs. care o poate prelua.
Trei pași
Formatul este cel pe care panourile SMM îl folosesc deja între ele, deci nu este nimic de programat.
https://smm.guide/api/v2 și cheia. Importați serviciile: rutele dvs. sosesc cu ID-urile, prețurile și limitele lor.Formatul solicitării
| Metoda HTTP | POST |
| URL API | https://smm.guide/api/v2 |
| Corp | application/x-www-form-urlencoded, sau JSON cu Content-Type: application/json. A multipart/form-data corpul este citit și el, adică ce trimite PHP când cURL primește un array |
| Răspuns | JSON, întotdeauna cu HTTP 200, inclusiv pentru un corp pe care nu îl putem citi sau o solicitare prea mare. O eroare este {"error": "…"} |
| Bani | Dolari americani. Prețurile sunt per 1.000 |
Lista de servicii
Rutele dvs. care pot prelua o comandă chiar acum. O rută dezactivată sau ai cărei pași sunt toți excluși nu este listată.
| Parametru | Descriere |
|---|---|
key | Cheia dvs. API |
action | services |
Răspuns
[
{
"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 este cel mai scump dintre pașii rutei care pot prelua o comandă, inclusiv cei omiși momentan (un panou căzut astăzi revine mâine), astfel încât o comandă nu costă niciodată mai mult decât prețul importat de panoul dvs. min și max sunt cele mai largi pe care le acoperă împreună pașii funcționali; o cantitate care se încadrează doar în limitele unora dintre ei merge la unul dintre aceștia. refill și cancel sunt true când fiecare astfel de pas le oferă.
O rută dezactivată sau fără niciun pas funcțional este exclusă din această listă până revine. Un panou care își sincronizează automat serviciile va dezactiva acel serviciu la el pentru aceeași perioadă, ceea ce și doriți: comenzile lui ar fi refuzate.
Adăugați o comandă
| Parametru | Descriere |
|---|---|
key | Cheia dvs. API |
action | add |
service | ID-ul rutei, opt cifre |
link | Linkul către pagină, postare sau profil |
quantity | Cantitatea necesară |
Răspuns
{
"order": 23501
}
Nimeni nu a acceptat-o
{
"error": "No step of this route accepted the order. …"
}Numărul comenzii rămâne același pe toată durata comenzii, indiferent de furnizorul care o livrează în final. O rută acceptă un link și o cantitate; livrarea treptată, comentariile și alte câmpuri suplimentare sunt refuzate.
Starea comenzii
| Parametru | Descriere |
|---|---|
key | Cheia dvs. API |
action | status |
order | ID comandă |
Răspuns
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametru | Descriere |
|---|---|
key | Cheia dvs. API |
action | status |
orders | ID-uri de comenzi separate prin virgulă, până la 100 |
Răspuns
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Stare | Semnificație |
|---|---|
Pending | Acceptată de un furnizor și încă nepornită. De asemenea, o comandă la care un furnizor nu a dat un răspuns clar: ruta se oprește acolo până când o verificați în contul dvs. |
In progress, Processing | Un furnizor o livrează sau comanda este în drum spre pasul următor. |
Completed | Livrată integral. |
Partial | Livrată parțial; remains este ce nu s-a livrat. Se ia în calcul ce a livrat fiecare pas: când un pas a livrat o parte, iar restul a fost anulat la următorul, comanda este Partial, nu Canceled. Furnizorul decide asupra returnării restului sumei debitate. |
Canceled | Nu s-a livrat nimic și niciun alt pas nu a preluat comanda. charge arată ce a rămas debitat, dacă a rămas ceva. |
charge este suma debitată de furnizori pentru această comandă, în dolari, la cursul din ziua plasării. start_count provine de la furnizorul care a pornit-o.
Sold
smm.guide nu deține niciun ban al dvs. Cifra este suma soldurilor dvs. de pe panourile din spatele rutelor, în dolari.
| Parametru | Descriere |
|---|---|
key | Cheia dvs. API |
action | balance |
Răspuns
{
"balance": "126.1375",
"currency": "USD"
}Anulați
Transmisă furnizorului care deține comanda acum, dacă serviciul său oferă anulare. O comandă pe care o anulați nu este trimisă niciodată la pasul următor.
| Parametru | Descriere |
|---|---|
key | Cheia dvs. API |
action | cancel |
orders | ID-uri de comenzi separate prin virgulă, până la 100 |
Răspuns
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Refill
Transmis furnizorului care a livrat comanda. Refill-ul poartă numărul propriu al comenzii.
| Parametru | Descriere |
|---|---|
key | Cheia dvs. API |
action | refill |
order | ID-ul comenzii. Sau orders: mai multe, separate prin virgulă |
Răspuns, o comandă
{ "refill": "23501" }
Răspuns, mai multe
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parametru | Descriere |
|---|---|
key | Cheia dvs. API |
action | refill_status |
refill | ID-ul refill-ului. Sau refills: mai multe, separate prin virgulă |
Răspuns
{ "status": "Completed" }Ce face o rută cu o comandă
- Pașii sunt încercați în ordinea dvs. sau începând cu cel mai ieftin pas funcțional. Alegeți varianta în setările rutei.
- Un pas este omis când panoul său nu răspunde, soldul sau limita zilnică nu acoperă comanda, cantitatea este în afara limitelor acceptate, prețul depășește limita setată de dvs. sau, la prețul său, comanda ar depăși limita zilnică a rutei. Revine automat.
- Un pas este exclus când serviciul său dispare din lista de prețuri sau panoul începe să vândă altceva sub același ID. Ceilalți pași continuă să funcționeze și sunteți anunțat.
- Un refuz trimite comanda mai departe. Când un panou răspunde și refuză, nu s-a debitat nimic, așa că se încearcă pasul următor.
- Lipsa unui răspuns clar o oprește. Un timeout sau un răspuns defect nu spune dacă comanda există. Trimiterea ei mai departe ar putea duce la livrare și debitare dublă, așa că ruta se oprește, iar dvs. verificați acea comandă în contul dvs.
- O singură comandă activă per link. Cât timp o comandă pentru un link rulează pe o rută, a doua pentru același link este refuzată, cum fac și furnizorii.
- O anulare înainte de livrare poate trece și ea mai departe, dacă ați activat această opțiune. Ce a rămas nelivrat dintr-o comandă parțială trece mai departe doar dacă ați cerut asta.
Erori
| Eroare | Ce înseamnă |
|---|---|
Invalid API key | Cheia este greșită, înlocuită sau revocată. |
This key is limited to certain addresses… | Solicitarea a venit de la o adresă care nu se află pe lista cheii. |
Incorrect request | Necunoscut action. |
Incorrect service ID | Nicio rută a dvs. nu are acest ID. O rută ștearsă își păstrează numărul, iar acesta nu este atribuit niciodată alteia. |
Incorrect order ID | Nicio comandă a dvs. nu are acest număr. |
Link is required, Quantity is required | Un câmp din add lipsește sau nu este un număr. |
A route takes a link and a quantity only | Solicitarea conținea livrare treptată, comentarii sau alt câmp suplimentar. |
This route is switched off | Activați-o în contul dvs. |
This route already has an order for this link… | Așteptați până se încheie cea activă. |
No step of this route can take this order right now. … | Fiecare pas a fost omis înainte de a se trimite ceva. Textul numește fiecare panou și motivul. |
No step of this route accepted the order. … | Fiecare pas solicitat a refuzat. Nu s-a debitat nimic. |
Too many requests… | Peste limita de mai jos. Așteptați un minut. |
Exemple
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]);
O solicitare add primește întotdeauna răspuns în cel mult 30 de secunde. O rută poate întreba mai mulți furnizori, unul după altul; fiecare primește ce a rămas din acest timp, iar un furnizor care nu ar mai putea fi așteptat nu este întrebat deloc. Dacă ultimul întrebat nu a răspuns când timpul expiră, primiți un număr de comandă cu starea Pending, iar ruta se oprește acolo până când răspunsul este cunoscut. Majoritatea comenzilor primesc răspuns în una-două secunde.
Limite și securitate
- 300 cereri pe minut per cheie, dintre care 120 comenzi. Până la 100 ID-uri de comenzi într-o singură
statusapel. - Cheia este afișată o singură dată și păstrată ca amprentă. Nici dvs., nici noi nu o mai putem citi. Înlocuirea ei o dezactivează imediat pe cea veche.
- Adrese permise. Indicați în cont adresa serverului panoului dvs., iar cheia nu va funcționa de nicăieri altundeva.
- Un ID de rută nu este secret și nici nu trebuie să fie. Funcționează doar împreună cu cheia contului care deține ruta.
- Limitele dvs. rămân valabile. Limita zilnică a fiecărui panou, limita zilnică a rutei și comanda ei maximă se aplică comenzilor sosite prin API exact ca celor plasate manual.
- Banii nu trec niciodată prin smm.guide. Fiecare comandă se plătește din soldul dvs. de pe panoul care o preia. Rambursările și disputele rămân între dvs. și acel panou.
Doriți de fapt să citiți catalogul?
Panourile, scorurile Trust Score și prețurile live au propriul API, plus un server MCP pentru asistenți.