હોમ / ડેવલપર / Orders API

Orders API

smm.guide ને તમારી પેનલમાં પ્રોવાઇડર તરીકે ઉમેરો. તમારા એકાઉન્ટમાં તમે બનાવો તે દરેક રૂટ પોતાના ID સાથેની સેવા છે: તમારી પેનલ એ ID પર ઑર્ડર મોકલે છે, અને રૂટ તેને તમારા પ્રોવાઇડરમાંથી તેને લઈ શકે તેવા પહેલા પ્રોવાઇડરને આપે છે.

ત્રણ સ્ટેપ

ફૉર્મેટ એ જ છે જે SMM પેનલ પહેલેથી અંદરોઅંદર વાપરે છે, તેથી કંઈ પ્રોગ્રામ કરવાનું નથી.

1રૂટ બનાવોએકાઉન્ટ, Orders desk, રૂટ. તે શું ડિલિવર કરશે તે પસંદ કરો અને તમે કનેક્ટ કરેલી પેનલમાંથી એ પ્રકારની પાંચ સુધી સેવાઓ ઉમેરો.
2કી બનાવોOrders desk, Orders API. કી એક જ વાર બતાવાય છે. તમે તેને તમારી પેનલના સર્વરના સરનામા સુધી મર્યાદિત કરી શકો છો.
3તમારી પેનલમાં પ્રોવાઇડર ઉમેરોAPI URL https://smm.guide/api/v2 અને કી. સેવાઓ ઇમ્પોર્ટ કરો: તમારા રૂટ તેમના ID, કિંમતો અને મર્યાદાઓ સાથે આવે છે.

વિનંતીનું ફૉર્મેટ

HTTP મેથડPOST
API URLhttps://smm.guide/api/v2
બૉડીapplication/x-www-form-urlencoded, અથવા આ સાથે JSON: Content-Type: application/json. A multipart/form-data બૉડી પણ વંચાય છે, જે cURL ને array આપવામાં આવે ત્યારે PHP મોકલે છે
જવાબJSON, હંમેશાં HTTP 200 સાથે, જે બૉડી અમે વાંચી ન શકીએ અથવા જે વિનંતી ખૂબ મોટી હોય તેના માટે પણ. ભૂલ આ રીતે આવે છે: {"error": "…"}
પૈસાUS ડૉલર. કિંમતો પ્રતિ 1,000 છે

સેવાઓની સૂચિ

તમારા રૂટ જે અત્યારે ઑર્ડર લઈ શકે છે. બંધ કરેલો રૂટ, અથવા જેનું દરેક સ્ટેપ બહાર હોય તે રૂટ, સૂચિમાં નથી.

પેરામીટરવર્ણન
keyતમારી API કી
actionservices

જવાબ

[
  {
    "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 એ રૂટનાં ઑર્ડર લઈ શકે તેવાં સ્ટેપમાંથી સૌથી મોંઘું છે, હાલ પૂરતાં છોડેલાં સ્ટેપ સહિત (આજે બંધ પેનલ કાલે પાછી આવે છે), જેથી ઑર્ડર ક્યારેય તમારી પેનલે ઇમ્પોર્ટ કરેલી કિંમતથી વધુ મોંઘો ન પડે. min અને max કામ કરતાં સ્ટેપ મળીને આપે તે સૌથી પહોળી મર્યાદા છે; જે જથ્થો તેમાંથી ફક્ત કેટલાંકમાં બંધબેસે તે એમાંથી કોઈ એક પર જાય છે. refill અને cancel ત્યારે true હોય છે જ્યારે આવું દરેક સ્ટેપ તે આપે.

બંધ કરેલો રૂટ, અથવા જેમાં કામ કરી શકે તેવું એક પણ સ્ટેપ ન હોય તે રૂટ, પાછો આવે ત્યાં સુધી આ સૂચિમાંથી બહાર રહે છે. જે પેનલ પોતાની સેવાઓ આપમેળે સિંક કરે છે તે એટલા સમય માટે પોતાની બાજુએ એ સેવા બંધ કરી દેશે, અને તમે એ જ ઇચ્છો છો: નહીંતર તેના ઑર્ડર નકારાત.

ઑર્ડર ઉમેરો

પેરામીટરવર્ણન
keyતમારી API કી
actionadd
serviceરૂટનો ID, આઠ અંક
linkપેજ, પોસ્ટ અથવા પ્રોફાઇલની લિંક
quantityજરૂરી જથ્થો

જવાબ

{
  "order": 23501
}

કોઈએ સ્વીકાર્યો નહીં

{
  "error": "No step of this route accepted the order. …"
}

ઑર્ડરનો નંબર તેના આખા જીવનકાળ દરમિયાન એ જ રહે છે, ભલે અંતે ગમે તે પ્રોવાઇડર તેને ડિલિવર કરે. રૂટ લિંક અને જથ્થો લે છે; ડ્રિપ-ફીડ, કૉમેન્ટ અને અન્ય વધારાનાં ફીલ્ડ નકારાય છે.

ઑર્ડર સ્ટેટસ

પેરામીટરવર્ણન
keyતમારી API કી
actionstatus
orderઑર્ડર ID

જવાબ

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
પેરામીટરવર્ણન
keyતમારી API કી
actionstatus
ordersઅલ્પવિરામથી અલગ કરેલા ઑર્ડર ID, 100 સુધી

જવાબ

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
સ્ટેટસઅર્થ
Pendingપ્રોવાઇડરે સ્વીકાર્યો છે અને હજી શરૂ થયો નથી. એવો ઑર્ડર પણ જેના પર પ્રોવાઇડરે સ્પષ્ટ જવાબ આપ્યો નથી: તમે તેને તમારા એકાઉન્ટમાં તપાસો ત્યાં સુધી રૂટ ત્યાં અટકે છે.
In progress, Processingકોઈ પ્રોવાઇડર તેને ડિલિવર કરી રહ્યો છે, અથવા ઑર્ડર આગલા સ્ટેપ પર જઈ રહ્યો છે.
Completedપૂરેપૂરો ડિલિવર થયો.
Partialથોડો ભાગ ડિલિવર થયો; remains એટલે જે ડિલિવર ન થયું તે. તે દરેક સ્ટેપે ડિલિવર કરેલું ગણે છે: જ્યારે એક સ્ટેપે ભાગ ડિલિવર કર્યો અને બાકીનું આગલા સ્ટેપ પર રદ થયું, ત્યારે ઑર્ડર Partial છે, Canceled નહીં. બાકીનો ચાર્જ પરત કરવા અંગે પ્રોવાઇડર નક્કી કરે છે.
Canceledકંઈ ડિલિવર થયું નથી, અને બીજા કોઈ સ્ટેપે ઑર્ડર લીધો નથી. charge બતાવે છે કે કંઈ ચાર્જ રહ્યું હોય તો કેટલું.

charge એ છે જે પ્રોવાઇડરોએ આ ઑર્ડર માટે ચાર્જ કર્યું, ઑર્ડર આપ્યો તે દિવસના દરે ડૉલરમાં. start_count તેને શરૂ કરનાર પ્રોવાઇડર પાસેથી આવે છે.

બૅલેન્સ

smm.guide તમારા કોઈ પૈસા રાખતું નથી. આ આંકડો તમારા રૂટ પાછળની પેનલ પરના તમારા બૅલેન્સનો સરવાળો છે, ડૉલરમાં.

પેરામીટરવર્ણન
keyતમારી API કી
actionbalance

જવાબ

{
  "balance": "126.1375",
  "currency": "USD"
}

રદ કરો

હાલ ઑર્ડર ધરાવતા પ્રોવાઇડરને આપવામાં આવે છે, જો તેની સેવા કૅન્સલ આપતી હોય. તમે રદ કરેલો ઑર્ડર ક્યારેય આગલા સ્ટેપ પર મોકલાતો નથી.

પેરામીટરવર્ણન
keyતમારી API કી
actioncancel
ordersઅલ્પવિરામથી અલગ કરેલા ઑર્ડર ID, 100 સુધી

જવાબ

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

રિફિલ

ઑર્ડર ડિલિવર કરનાર પ્રોવાઇડરને આપવામાં આવે છે. રિફિલમાં ઑર્ડરનો પોતાનો નંબર જ હોય છે.

પેરામીટરવર્ણન
keyતમારી API કી
actionrefill
orderઑર્ડર ID. અથવા orders: અનેક, અલ્પવિરામથી અલગ કરેલા

જવાબ, એક ઑર્ડર

{ "refill": "23501" }

જવાબ, અનેક

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
પેરામીટરવર્ણન
keyતમારી API કી
actionrefill_status
refillરિફિલ ID. અથવા refills: અનેક, અલ્પવિરામથી અલગ કરેલા

જવાબ

{ "status": "Completed" }

રૂટ ઑર્ડર સાથે શું કરે છે

  • સ્ટેપ તમારા ક્રમમાં અજમાવાય છે, અથવા સૌથી સસ્તું કામ કરતું સ્ટેપ પહેલાં. કયું, તે તમે રૂટમાં પસંદ કરો છો.
  • સ્ટેપ છોડી દેવાય છે જ્યારે તેની પેનલ જવાબ ન આપતી હોય, તેનું બૅલેન્સ કે દૈનિક મર્યાદા ઑર્ડરને આવરી ન લે, જથ્થો તે સ્વીકારે તે મર્યાદાની બહાર હોય, તેની કિંમત તમે સેટ કરેલી મર્યાદાથી વધુ હોય, અથવા તેની કિંમતે ઑર્ડર રૂટની પોતાની દૈનિક મર્યાદા વટાવી જાય. તે જાતે પાછું આવે છે.
  • સ્ટેપ બહાર થાય છે જ્યારે તેની સેવા પ્રાઇસ લિસ્ટમાંથી નીકળી જાય, અથવા પેનલ એ જ ID હેઠળ બીજું કંઈ વેચવા લાગે. બાકીનાં સ્ટેપ કામ કરતાં રહે છે, અને તમને જાણ કરવામાં આવે છે.
  • નકાર ઑર્ડરને આગળ લઈ જાય છે. જ્યારે પેનલ જવાબ આપે અને નકારે, ત્યારે કંઈ ચાર્જ થયું નથી, તેથી આગલું સ્ટેપ અજમાવાય છે.
  • અસ્પષ્ટ જવાબ તેને અટકાવે છે. ટાઇમઆઉટ અથવા તૂટેલો જવાબ એ નથી કહેતો કે ઑર્ડર બન્યો છે કે નહીં. તેને આગળ મોકલવાથી તે બે વાર ડિલિવર અને ચાર્જ થઈ શકે, તેથી રૂટ અટકે છે અને તમે એ એક ઑર્ડર તમારા એકાઉન્ટમાં તપાસો છો.
  • એક લિંક પર એક જ ચાલુ ઑર્ડર. કોઈ લિંક માટેનો ઑર્ડર રૂટ પર ચાલુ હોય ત્યારે એ જ લિંક માટેનો બીજો ઑર્ડર નકારાય છે, જેમ પ્રોવાઇડરો પોતે કરે છે.
  • ડિલિવરી પહેલાંનું કૅન્સલ પણ આગળ જઈ શકે છે, જો તમે એ ચાલુ કર્યું હોય. આંશિક ઑર્ડરમાં ડિલિવર ન થયેલો ભાગ ત્યારે જ આગળ જાય છે જ્યારે તમે તે માંગ્યું હોય.

ભૂલો

ભૂલતેનો અર્થ શું છે
Invalid API keyકી ખોટી છે, બદલાઈ ગઈ છે અથવા રદ થઈ છે.
This key is limited to certain addresses…વિનંતી એવા સરનામેથી આવી જે કીની સૂચિમાં નથી.
Incorrect requestઅજ્ઞાત action.
Incorrect service IDતમારા કોઈ રૂટનો આ ID નથી. તમે ડિલીટ કરેલો રૂટ પોતાનો નંબર રાખે છે, અને તે ક્યારેય બીજાને અપાતો નથી.
Incorrect order IDતમારા કોઈ ઑર્ડરનો આ નંબર નથી.
Link is required, Quantity is requiredઆમાંથી કોઈ ફીલ્ડ add ખૂટે છે અથવા સંખ્યા નથી.
A route takes a link and a quantity onlyવિનંતીમાં ડ્રિપ-ફીડ, કૉમેન્ટ અથવા અન્ય વધારાનું ફીલ્ડ હતું.
This route is switched offતેને તમારા એકાઉન્ટમાં ચાલુ કરો.
This route already has an order for this link…ચાલુ ઑર્ડર પૂરો થાય ત્યાં સુધી રાહ જુઓ.
No step of this route can take this order right now. …કંઈ મોકલાય તે પહેલાં દરેક સ્ટેપ છોડી દેવાયું. લખાણમાં દરેક પેનલ અને તેનું કારણ લખેલું છે.
No step of this route accepted the order. …પૂછેલા દરેક સ્ટેપે નકાર્યું. કંઈ ચાર્જ થયું નથી.
Too many requests…નીચેની મર્યાદા વટાવી. એક મિનિટ રાહ જુઓ.

ઉદાહરણો

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]);

દરેક add વિનંતીનો જવાબ હંમેશાં 30 સેકન્ડમાં મળે છે. રૂટ એક પછી એક અનેક પ્રોવાઇડરને પૂછી શકે છે; દરેકને એ સમયમાંથી બાકી રહેલો સમય મળે છે, અને જેની રાહ જોઈ ન શકાય તે પ્રોવાઇડરને પૂછવામાં જ નથી આવતું. જો સમય પૂરો થાય ત્યારે છેલ્લા પૂછેલા પ્રોવાઇડરે જવાબ ન આપ્યો હોય, તો તમને Pending સ્ટેટસ સાથે ઑર્ડર નંબર મળે છે, અને જવાબ જાણી શકાય ત્યાં સુધી રૂટ ત્યાં અટકે છે. મોટાભાગના ઑર્ડરનો જવાબ એક-બે સેકન્ડમાં મળે છે.

મર્યાદાઓ અને સુરક્ષા

  • કી દીઠ મિનિટે 300 વિનંતીઓ, તેમાંથી 120 ઓર્ડર. એકમાં 100 સુધી ઓર્ડર ID status કૉલ.
  • કી એક જ વાર બતાવાય છે અને ફિંગરપ્રિન્ટ તરીકે રખાય છે. ન તમે, ન અમે તેને ફરી વાંચી શકીએ. તેને બદલતાં જ જૂની કી તરત બંધ થઈ જાય છે.
  • મંજૂર સરનામાં. તમારા એકાઉન્ટમાં તમારી પેનલના સર્વરનું સરનામું ઉમેરો, અને કી બીજે ક્યાંયથી કામ નહીં કરે.
  • રૂટ ID ગુપ્ત નથી, અને તેની જરૂર પણ નથી. તે ફક્ત રૂટના માલિક એકાઉન્ટની કી સાથે જ કામ કરે છે.
  • તમારી મર્યાદાઓ લાગુ રહે છે. દરેક પેનલની દૈનિક મર્યાદા, રૂટની પોતાની દૈનિક મર્યાદા અને તેનો સૌથી મોટો ઑર્ડર API દ્વારા આવતા ઑર્ડર પર પણ એ જ રીતે લાગુ પડે છે જેમ તમે હાથથી આપેલા ઑર્ડર પર.
  • પૈસા ક્યારેય smm.guide મારફતે પસાર થતા નથી. દરેક ઑર્ડરની ચુકવણી તેને લેતી પેનલ પરના તમારા બૅલેન્સમાંથી થાય છે. રિફંડ અને વિવાદ તમારી અને એ પેનલ વચ્ચે રહે છે.

તેના બદલે કૅટલૉગ વાંચવો છે?

પેનલ, Trust Score અને લાઇવ કિંમતોનું પોતાનું API છે, અને આસિસ્ટન્ટ માટે MCP સર્વર પણ.