Orders API
Legg til smm.guide i panelet ditt som leverandør. Hver rute du lager i kontoen din, er en tjeneste med sin egen ID: panelet ditt sender en bestilling til den ID-en, og ruten sender den videre til den første av leverandørene dine som kan ta den.
Tre trinn
Formatet er det SMM-paneler allerede bruker seg imellom, så det er ingenting å programmere.
https://smm.guide/api/v2 og nøkkelen. Importer tjenestene: rutene dine kommer inn med ID-er, priser og grenser.Forespørselsformat
| HTTP-metode | POST |
| API-URL | https://smm.guide/api/v2 |
| Body | application/x-www-form-urlencoded, eller JSON med Content-Type: application/json. A multipart/form-data body leses også, som er det PHP sender når cURL får en matrise |
| Svar | JSON, alltid med HTTP 200, også for en body vi ikke kan lese eller en forespørsel som er for stor. En feil er {"error": "…"} |
| Penger | Amerikanske dollar. Prisene er per 1 000 |
Tjenesteliste
Rutene dine som kan ta en bestilling akkurat nå. En rute som er slått av, eller der alle trinnene er ute, vises ikke.
| Parameter | Beskrivelse |
|---|---|
key | API-nøkkelen din |
action | services |
Svar
[
{
"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 er det dyreste av rutens trinn som kan ta en bestilling, inkludert de som hoppes over for øyeblikket (et panel som er nede i dag, er tilbake i morgen), så en bestilling koster aldri mer enn prisen panelet ditt importerte. min og max er de videste grensene de fungerende trinnene dekker til sammen; et antall som bare passer noen av dem, går til et av disse. refill og cancel er true når hvert slikt trinn tilbyr dem.
En rute som er slått av, eller som ikke har noe trinn som kan fungere, utelates fra denne listen til den er tilbake. Et panel som synkroniserer tjenestene sine automatisk, slår av den tjenesten hos seg i samme tidsrom, og det er det du vil: bestillingene ville blitt avvist.
Legg til bestilling
| Parameter | Beskrivelse |
|---|---|
key | API-nøkkelen din |
action | add |
service | Rutens ID, åtte sifre |
link | Lenke til siden, innlegget eller profilen |
quantity | Ønsket antall |
Svar
{
"order": 23501
}
Ingen tok imot den
{
"error": "No step of this route accepted the order. …"
}Ordrenummeret er det samme gjennom hele bestillingens levetid, uansett hvilken leverandør som til slutt leverer den. En rute tar en lenke og et antall; gradvis levering, kommentarer og andre ekstrafelt avvises.
Ordrestatus
| Parameter | Beskrivelse |
|---|---|
key | API-nøkkelen din |
action | status |
order | Ordre-ID |
Svar
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Beskrivelse |
|---|---|
key | API-nøkkelen din |
action | status |
orders | Ordre-ID-er atskilt med komma, opptil 100 |
Svar
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Status | Betydning |
|---|---|
Pending | Godtatt av en leverandør og ikke startet ennå. Også en bestilling der en leverandør ikke ga et klart svar: ruten stopper der til du har sjekket den i kontoen din. |
In progress, Processing | En leverandør leverer den, eller bestillingen er på vei til neste trinn. |
Completed | Levert i sin helhet. |
Partial | Delvis levert; remains er det som ikke ble levert. Det teller det alle trinnene leverte: når ett trinn leverte en del og resten ble kansellert på det neste, er bestillingen Delvis, ikke Kansellert. Leverandøren avgjør om resten av beløpet returneres. |
Canceled | Ingenting ble levert, og ingen andre trinn tok bestillingen. charge viser hva som eventuelt forble trukket. |
charge er det leverandørene tok betalt for denne bestillingen, i dollar etter kursen den dagen den ble lagt inn. start_count kommer fra leverandøren som startet den.
Saldo
smm.guide holder ingen av pengene dine. Tallet er summen av saldoene dine på panelene bak rutene dine, i dollar.
| Parameter | Beskrivelse |
|---|---|
key | API-nøkkelen din |
action | balance |
Svar
{
"balance": "126.1375",
"currency": "USD"
}Avbryt
Sendes til leverandøren som har bestillingen nå, hvis tjenesten tilbyr kansellering. En bestilling du kansellerer, sendes aldri videre til neste trinn.
| Parameter | Beskrivelse |
|---|---|
key | API-nøkkelen din |
action | cancel |
orders | Ordre-ID-er atskilt med komma, opptil 100 |
Svar
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Etterfylling
Sendes til leverandøren som leverte bestillingen. Etterfyllingen har bestillingens eget nummer.
| Parameter | Beskrivelse |
|---|---|
key | API-nøkkelen din |
action | refill |
order | Ordre-ID. Eller orders: flere, atskilt med komma |
Svar, én bestilling
{ "refill": "23501" }
Svar, flere
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Beskrivelse |
|---|---|
key | API-nøkkelen din |
action | refill_status |
refill | Etterfyllings-ID. Eller refills: flere, atskilt med komma |
Svar
{ "status": "Completed" }Hva en rute gjør med en bestilling
- Trinnene prøves i din rekkefølge, eller det billigste fungerende først. Du velger hvilken i ruten.
- Et trinn hoppes over når panelet ikke svarer, saldoen eller dagsgrensen ikke dekker bestillingen, antallet er utenfor det trinnet tar, prisen er over grensen du har satt, eller bestillingen til den prisen ville gått over rutens egen dagsgrense. Det kommer tilbake av seg selv.
- Et trinn faller ut når tjenesten forsvinner fra prislisten, eller panelet begynner å selge noe annet under samme ID. De andre trinnene fortsetter å fungere, og du får beskjed.
- Et avslag sender bestillingen videre. Når et panel svarer og avslår, er ingenting trukket, så neste trinn prøves.
- Uklart svar stopper den. Et tidsavbrudd eller et ødelagt svar sier ikke om bestillingen finnes. Å sende den videre kan levere og belaste den to ganger, så ruten stopper, og du sjekker den ene bestillingen i kontoen din.
- Én aktiv bestilling per lenke. Mens en bestilling for en lenke kjører på en rute, avvises en ny for samme lenke, slik leverandørene selv gjør.
- En kansellering før levering kan også gå videre, hvis du har slått det på. Det en delvis bestilling ikke leverte, går bare videre hvis du har bedt om det.
Feil
| Feil | Hva det betyr |
|---|---|
Invalid API key | Nøkkelen er feil, erstattet eller tilbakekalt. |
This key is limited to certain addresses… | Forespørselen kom fra en adresse som ikke står på nøkkelens liste. |
Incorrect request | Ukjent action. |
Incorrect service ID | Ingen av rutene dine har denne ID-en. En rute du har slettet, beholder nummeret sitt, og det gis aldri til en annen. |
Incorrect order ID | Ingen av bestillingene dine har dette nummeret. |
Link is required, Quantity is required | Et felt i add mangler eller er ikke et tall. |
A route takes a link and a quantity only | Forespørselen inneholdt gradvis levering, kommentarer eller et annet ekstrafelt. |
This route is switched off | Slå det på i kontoen din. |
This route already has an order for this link… | Vent til den som kjører, er ferdig. |
No step of this route can take this order right now. … | Alle trinn ble hoppet over før noe ble sendt. Teksten nevner hvert panel og årsaken. |
No step of this route accepted the order. … | Alle trinn som ble spurt, avslo. Ingenting ble trukket. |
Too many requests… | Over grensen nedenfor. Vent ett minutt. |
Eksempler
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]);
Et add besvares alltid innen 30 sekunder. En rute kan spørre flere leverandører etter hverandre; hver får det som er igjen av den tiden, og en leverandør det ikke er tid til å vente på, blir ikke spurt i det hele tatt. Hvis den siste som ble spurt, ikke har svart når tiden er ute, får du et ordrenummer med statusen Venter, og ruten stopper der til svaret er kjent. De fleste bestillinger besvares på ett eller to sekunder.
Grenser og sikkerhet
- 300 forespørsler i minuttet per nøkkel, 120 av dem bestillinger. Opptil 100 ordre-ID-er i én
statuskall. - Nøkkelen vises én gang og lagres som et fingeravtrykk. Verken du eller vi kan lese den igjen. Når du erstatter den, slås den gamle av umiddelbart.
- Tillatte adresser. Oppgi adressen til panelserveren din i kontoen din, så fungerer nøkkelen ikke fra noe annet sted.
- En rute-ID er ikke en hemmelighet og trenger ikke å være det. Den fungerer bare sammen med nøkkelen til kontoen som eier ruten.
- Grensene dine gjelder fortsatt. Dagsgrensen for hvert panel, rutens egen dagsgrense og største bestilling gjelder for bestillinger som kommer via API-et, akkurat som for dem du legger inn manuelt.
- Penger går aldri gjennom smm.guide. Hver bestilling betales fra saldoen din på panelet som tar den. Refusjoner og tvister er mellom deg og det panelet.
Vil du heller lese katalogen?
Paneler, Trust Score og sanntidspriser har et eget API, og en MCP-server for assistenter.