Startseite / Entwickler / Orders API
Orders API
Fügen Sie smm.guide Ihrem Panel als Anbieter hinzu. Jede Route, die Sie in Ihrem Konto erstellen, ist ein Service mit eigener ID: Ihr Panel sendet eine Bestellung an diese ID, und die Route gibt sie an den ersten Ihrer Anbieter weiter, der sie annehmen kann.
Drei Schritte
Das Format ist dasselbe, das SMM-Panels bereits untereinander verwenden, es gibt also nichts zu programmieren.
https://smm.guide/api/v2 und den Schlüssel. Importieren Sie die Services: Ihre Routen kommen mit ihren IDs, Preisen und Limits an.Anfrageformat
| HTTP-Methode | POST |
| API-URL | https://smm.guide/api/v2 |
| Body | application/x-www-form-urlencoded, oder JSON mit Content-Type: application/json. A multipart/form-data -Body wird ebenfalls gelesen; das sendet PHP, wenn cURL ein Array erhält |
| Antwort | JSON, immer mit HTTP 200, auch bei einem unlesbaren Body oder einer zu großen Anfrage. Ein Fehler ist {"error": "…"} |
| Geld | US-Dollar. Preise gelten pro 1.000 |
Service-Liste
Ihre Routen, die gerade eine Bestellung annehmen können. Eine ausgeschaltete Route oder eine, bei der alle Schritte ausgefallen sind, wird nicht aufgeführt.
| Parameter | Beschreibung |
|---|---|
key | Ihr API-Schlüssel |
action | services |
Antwort
[
{
"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 ist der teuerste der Schritte der Route, die eine Bestellung annehmen können, einschließlich der vorübergehend übersprungenen (ein Panel, das heute ausgefallen ist, ist morgen wieder da), sodass eine Bestellung nie mehr kostet als der Preis, den Ihr Panel importiert hat. min und max sind die weitesten Grenzen, die die funktionierenden Schritte gemeinsam abdecken; eine Menge, die nur zu einigen passt, geht an einen davon. refill und cancel sind true, wenn jeder dieser Schritte sie anbietet.
Eine Route, die ausgeschaltet ist oder keinen funktionsfähigen Schritt hat, fehlt in dieser Liste, bis sie wieder verfügbar ist. Ein Panel, das seine Services automatisch synchronisiert, schaltet diesen Service für dieselbe Zeit auf seiner Seite ab – genau das, was Sie wollen: Seine Bestellungen würden ohnehin abgelehnt.
Bestellung hinzufügen
| Parameter | Beschreibung |
|---|---|
key | Ihr API-Schlüssel |
action | add |
service | Die ID der Route, acht Ziffern |
link | Link zur Seite, zum Beitrag oder zum Profil |
quantity | Gewünschte Menge |
Antwort
{
"order": 23501
}
Kein Anbieter hat sie angenommen
{
"error": "No step of this route accepted the order. …"
}Die Bestellnummer bleibt über die gesamte Lebensdauer der Bestellung gleich, egal welcher Anbieter sie am Ende liefert. Eine Route nimmt einen Link und eine Menge an; Drip-Feed, Kommentare und andere Zusatzfelder werden abgelehnt.
Bestellstatus
| Parameter | Beschreibung |
|---|---|
key | Ihr API-Schlüssel |
action | status |
order | Bestell-ID |
Antwort
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Beschreibung |
|---|---|
key | Ihr API-Schlüssel |
action | status |
orders | Bestell-IDs durch Komma getrennt, bis zu 100 |
Antwort
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Status | Bedeutung |
|---|---|
Pending | Von einem Anbieter angenommen und noch nicht gestartet. Außerdem eine Bestellung, bei der ein Anbieter keine eindeutige Antwort gegeben hat: Die Route stoppt dort, bis Sie sie in Ihrem Konto geprüft haben. |
In progress, Processing | Ein Anbieter liefert sie, oder die Bestellung ist auf dem Weg zum nächsten Schritt. |
Completed | Vollständig geliefert. |
Partial | Teilweise geliefert; remains ist, was nicht geliefert wurde. Gezählt wird, was alle Schritte geliefert haben: Hat ein Schritt einen Teil geliefert und wurde der Rest beim nächsten storniert, ist die Bestellung Partial, nicht Canceled. Über die Erstattung des restlichen Betrags entscheidet der Anbieter. |
Canceled | Nichts wurde geliefert, und kein anderer Schritt hat die Bestellung übernommen. charge zeigt, was gegebenenfalls belastet blieb. |
charge ist der Betrag, den die Anbieter für diese Bestellung berechnet haben, in Dollar zum Kurs des Tages, an dem sie aufgegeben wurde. start_count stammt vom Anbieter, der sie gestartet hat.
Guthaben
smm.guide verwahrt kein Geld von Ihnen. Die Zahl ist die Summe Ihrer Guthaben auf den Panels hinter Ihren Routen, in Dollar.
| Parameter | Beschreibung |
|---|---|
key | Ihr API-Schlüssel |
action | balance |
Antwort
{
"balance": "126.1375",
"currency": "USD"
}Abbrechen
Wird an den Anbieter weitergegeben, der die Bestellung gerade hält, sofern sein Service eine Stornierung anbietet. Eine von Ihnen stornierte Bestellung wird nie an den nächsten Schritt weitergegeben.
| Parameter | Beschreibung |
|---|---|
key | Ihr API-Schlüssel |
action | cancel |
orders | Bestell-IDs durch Komma getrennt, bis zu 100 |
Antwort
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Refill
Wird an den Anbieter weitergegeben, der die Bestellung geliefert hat. Der Refill trägt die Nummer der Bestellung selbst.
| Parameter | Beschreibung |
|---|---|
key | Ihr API-Schlüssel |
action | refill |
order | Bestell-ID. Oder orders: mehrere, durch Komma getrennt |
Antwort, eine Bestellung
{ "refill": "23501" }
Antwort, mehrere
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Beschreibung |
|---|---|
key | Ihr API-Schlüssel |
action | refill_status |
refill | Refill-ID. Oder refills: mehrere, durch Komma getrennt |
Antwort
{ "status": "Completed" }Was eine Route mit einer Bestellung macht
- Die Schritte werden in Ihrer Reihenfolge versucht, oder der günstigste funktionierende zuerst. Was davon gilt, legen Sie in der Route fest.
- Ein Schritt wird übersprungen, wenn sein Panel nicht antwortet, sein Guthaben oder Tageslimit die Bestellung nicht deckt, die Menge außerhalb seines Bereichs liegt, sein Preis über dem von Ihnen gesetzten Limit liegt oder die Bestellung zu seinem Preis das eigene Tageslimit der Route überschreiten würde. Er kommt von selbst zurück.
- Ein Schritt fällt aus, wenn sein Service aus der Preisliste verschwindet oder das Panel unter derselben ID etwas anderes verkauft. Die anderen Schritte arbeiten weiter, und Sie werden informiert.
- Eine Ablehnung gibt die Bestellung weiter. Wenn ein Panel antwortet und ablehnt, wurde nichts belastet, daher wird der nächste Schritt versucht.
- Keine eindeutige Antwort stoppt sie. Ein Timeout oder eine fehlerhafte Antwort sagt nicht, ob die Bestellung existiert. Eine Weitergabe könnte sie doppelt ausführen und doppelt belasten, daher stoppt die Route, und Sie prüfen diese eine Bestellung in Ihrem Konto.
- Eine laufende Bestellung pro Link. Solange auf einer Route eine Bestellung für einen Link läuft, wird eine zweite für denselben Link abgelehnt – so wie es die Anbieter selbst tun.
- Auch eine Stornierung vor der Lieferung kann weitergegeben werden, wenn Sie das aktiviert haben. Was eine Teilbestellung nicht geliefert hat, wird nur weitergegeben, wenn Sie das so eingestellt haben.
Fehler
| Fehler | Bedeutung |
|---|---|
Invalid API key | Der Schlüssel ist falsch, ersetzt oder widerrufen. |
This key is limited to certain addresses… | Die Anfrage kam von einer Adresse, die nicht auf der Liste des Schlüssels steht. |
Incorrect request | Unbekannt action. |
Incorrect service ID | Keine Ihrer Routen hat diese ID. Eine gelöschte Route behält ihre Nummer, und diese wird nie an eine andere vergeben. |
Incorrect order ID | Keine Ihrer Bestellungen hat diese Nummer. |
Link is required, Quantity is required | Ein Feld von add fehlt oder ist keine Zahl. |
A route takes a link and a quantity only | Die Anfrage enthielt Drip-Feed, Kommentare oder ein anderes Zusatzfeld. |
This route is switched off | Aktivieren Sie es in Ihrem Konto. |
This route already has an order for this link… | Warten Sie, bis die laufende Bestellung abgeschlossen ist. |
No step of this route can take this order right now. … | Jeder Schritt wurde übersprungen, bevor etwas gesendet wurde. Der Text nennt jedes Panel und seinen Grund. |
No step of this route accepted the order. … | Jeder angefragte Schritt hat abgelehnt. Nichts wurde belastet. |
Too many requests… | Über dem Limit unten. Warten Sie eine Minute. |
Beispiele
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]);
Ein Aufruf von add wird immer innerhalb von 30 Sekunden beantwortet. Eine Route kann mehrere Anbieter nacheinander anfragen; jeder erhält den Rest dieser Zeit, und ein Anbieter, auf den nicht mehr gewartet werden könnte, wird gar nicht erst gefragt. Hat der zuletzt angefragte Anbieter bei Ablauf der Zeit nicht geantwortet, erhalten Sie eine Bestellnummer mit dem Status Pending, und die Route stoppt dort, bis die Antwort bekannt ist. Die meisten Bestellungen werden in ein bis zwei Sekunden beantwortet.
Limits und Sicherheit
- 300 Anfragen pro Minute je Schlüssel, davon 120 Bestellungen. Bis zu 100 Bestell-IDs pro
statusAufruf. - Der Schlüssel wird einmal angezeigt und als Fingerabdruck gespeichert. Weder Sie noch wir können ihn erneut lesen. Beim Ersetzen wird der alte sofort deaktiviert.
- Erlaubte Adressen. Tragen Sie die Server-Adresse Ihres Panels in Ihrem Konto ein, dann funktioniert der Schlüssel nirgendwo sonst.
- Eine Routen-ID ist kein Geheimnis und muss es auch nicht sein. Sie funktioniert nur zusammen mit dem Schlüssel des Kontos, dem die Route gehört.
- Ihre Limits gelten weiterhin. Das Tageslimit jedes Panels, das eigene Tageslimit der Route und ihre größte Bestellung gelten für Bestellungen über die API genauso wie für die, die Sie von Hand aufgeben.
- Geld fließt nie über smm.guide. Jede Bestellung wird von Ihrem Guthaben auf dem Panel bezahlt, das sie annimmt. Erstattungen und Streitfälle bleiben zwischen Ihnen und diesem Panel.
Sie möchten stattdessen den Katalog lesen?
Panels, Trust Scores und Live-Preise haben eine eigene API und einen MCP-Server für Assistenten.