API

API-Dokumentation

Eine POST-Anfrage für alles: Bestellung, Status, Dienstliste, Guthaben. Kompatibel mit Perfect Panel und SmartPanel.

Adressehttps://stream-promotion.ru/api/v2

MethodePOST

FormatJSON

WährungUSDStandard, in den Einstellungen änderbar

Das ist die Shop-API. Der Zuschauer-Konfigurator hat eine eigene API: andere Adresse, andere Autorisierung. Der Schlüssel ist derselbe.

Drei Fehler, an denen es meistens scheitert

Die Anfrage wurde mit GET gesendet. Akzeptiert wird nur POST.
Parameter stehen in der Adresszeile. Sie gehören in den Anfragekörper, nicht in die Query.
Kein User-Agent gesetzt. Beim Testen mit Postman oder curl explizit angeben.

Für das, was Sie über die API senden, sind Sie selbst verantwortlich. Lesen Sie die Methodenbeschreibung vor dem Anbinden.

Schlüssel erhalten

Im Konto anmelden.
Bereich «API-Einstellungen» öffnen.
Schlüssel und Adresse kopieren und im eigenen Panel eintragen.

Die Dienstliste kommt in der Sprache, die in den API-Einstellungen gewählt ist. Die Preiswährung wird dort ebenfalls gewählt — standardmäßig USD.

Schnellstart

Prüfen Sie die Verbindung mit einer Guthaben-Anfrage — die einfachste, sie legt nichts an.

curl -X POST https://stream-promotion.ru/api/v2 \
  -H "User-Agent: MyPanel/1.0" \
  -d "key=IHR_SCHLUESSEL" \
  -d "action=balance"

<?php
$ch = curl_init('https://stream-promotion.ru/api/v2');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERAGENT, 'MyPanel/1.0');
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key'    => 'IHR_SCHLUESSEL',
    'action' => 'balance',
]));
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($res);

import requests

res = requests.post(
    "https://stream-promotion.ru/api/v2",
    data={"key": "IHR_SCHLUESSEL", "action": "balance"},
    headers={"User-Agent": "MyPanel/1.0"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://stream-promotion.ru/api/v2", {
  method: "POST",
  headers: {
    "Content-Type": "application/x-www-form-urlencoded",
    "User-Agent": "MyPanel/1.0",
  },
  body: new URLSearchParams({
    key: "IHR_SCHLUESSEL",
    action: "balance",
  }),
});

console.log(await res.json());

Antwort

{
    "status": "success",
    "balance": "0.03",
    "currency": "USD"
}

Methoden

Die Methode wählt der Parameter action. Der key ist immer erforderlich.

Bestellung anlegen

Die Hauptmethode. runs und interval teilen die Lieferung auf: 7 Läufe mit 1440 Minuten Abstand strecken die Bestellung über eine Woche.

Der Parametersatz hängt vom Diensttyp ab — wählen Sie ihn in der Liste, die Tabelle aktualisiert sich.

Parameter	Beschreibung
`key`erforderlich	Ihr Schlüssel aus den API-Einstellungen
`action`erforderlich	`add`
`service`erforderlich	Dienst-ID aus der Liste
`link`erforderlich	Link zu Kanal, Stream oder Seite
`quantity`erforderlich	Menge
`runs`optional	Anzahl der Läufe
`interval`optional	Pause zwischen den Läufen, in Minuten. Ganze Zahl: 10, 20, 30, 60

Antwort

{
    "status": "success",
    "order": 32
}

Bestellung mit Kommentaren

Eigener Bestelltyp: statt einer Menge übergeben Sie eine Kommentarliste. Passend für Erwähnungen und eigene Kommentare.

Parameter	Beschreibung
`key`erforderlich	Ihr Schlüssel aus den API-Einstellungen
`action`erforderlich	`add`
`service`erforderlich	Paket-ID
`link`erforderlich	Link zu Kanal, Stream oder Seite
`comments`erforderlich	Kommentare, je einer pro Zeile

Antwort

{
    "status": "success",
    "order": 32
}

Bestellstatus

Parameter	Beschreibung
`key`erforderlich	Ihr Schlüssel aus den API-Einstellungen
`action`erforderlich	`status`
`order`erforderlich	Bestell-ID

Antwort

{
    "order": "32",
    "status": "pending",
    "charge": "0.27819",
    "start_count": "0",
    "remains": "0",
    "currency": "USD"
}

Status mehrerer Bestellungen

Bis zu hundert Bestellungen in einer Anfrage — statt hundert einzelner.

Parameter	Beschreibung
`key`erforderlich	Ihr Schlüssel aus den API-Einstellungen
`action`erforderlich	`status`
`orders`erforderlich	IDs durch Komma: `12,13,14`

Antwort

{
    "12": {
        "order": "12",
        "status": "completed",
        "charge": "0.27819",
        "currency": "USD"
    },
    "13": {
        "error": "Incorrect order ID"
    }
}

Dienstliste

Gibt alle verfügbaren Dienste mit Preisen zurück. Die Sprache der Namen stammt aus den API-Einstellungen, die Preise sind immer in Dollar.

Parameter	Beschreibung
`key`erforderlich	Ihr Schlüssel aus den API-Einstellungen
`action`erforderlich	`services`

Antwort

[
    {
        "service": "5",
        "name": "Instagram Followers",
        "rate": "0.9",
        "min": "50",
        "max": "10000",
        "type": "Default",
        "category": "Instagram"
    }
]

Guthaben

Die einfachste Methode — praktisch, um zu prüfen, ob der Schlüssel funktioniert.

Parameter	Beschreibung
`key`erforderlich	Ihr Schlüssel aus den API-Einstellungen
`action`erforderlich	`balance`

Antwort

{
    "status": "success",
    "balance": "0.03",
    "currency": "USD"
}

Fehler

Bei einem Fehler enthält die Antwort das Feld error mit einer Beschreibung. Der HTTP-Code bleibt dabei 200 — prüfen Sie den Antwortkörper, nicht den Verbindungsstatus.