API

API-documentatie

Eén POST-verzoek voor alles: bestelling, status, dienstenlijst, saldo. Compatibel met Perfect Panel en SmartPanel.

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

MethodePOST

FormaatJSON

ValutaUSDstandaard, aanpasbaar in de instellingen

Dit is de shop-API. De kijkersconfigurator heeft een eigen API: ander adres en andere autorisatie. De sleutel is wel dezelfde.

Drie fouten waardoor het meestal misgaat

Het verzoek is met GET verstuurd. Alleen POST wordt geaccepteerd.
Parameters staan in de URL. Ze horen in de body van het verzoek, niet in de query.
Geen User-Agent ingesteld. Geef die bij tests met Postman of curl expliciet op.

U bent zelf verantwoordelijk voor wat u via de API verstuurt. Lees de beschrijving van de methoden voordat u koppelt.

Sleutel verkrijgen

Log in op uw account.
Open het onderdeel «API-instellingen».
Kopieer de sleutel en het adres, voeg ze toe aan uw panel.

De dienstenlijst komt in de taal die in de API-instellingen is gekozen. De prijsvaluta kiest u daar ook — standaard USD.

Snelle start

Test de verbinding met een saldoverzoek: het eenvoudigste en het maakt niets aan.

curl -X POST https://stream-promotion.ru/api/v2 \
  -H "User-Agent: MyPanel/1.0" \
  -d "key=UW_SLEUTEL" \
  -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'    => 'UW_SLEUTEL',
    '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": "UW_SLEUTEL", "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: "UW_SLEUTEL",
    action: "balance",
  }),
});

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

Antwoord

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

Methoden

De methode kiest u met de parameter action. De key is altijd verplicht.

Bestelling aanmaken

De hoofdmethode. runs en interval verdelen de levering: 7 runs met 1440 minuten ertussen spreiden de bestelling over een week.

De set parameters hangt af van het diensttype — kies het in de lijst en de tabel wordt bijgewerkt.

Parameter	Beschrijving
`key`verplicht	Uw sleutel uit de API-instellingen
`action`verplicht	`add`
`service`verplicht	Dienst-ID uit de lijst
`link`verplicht	Link naar kanaal, stream of pagina
`quantity`verplicht	Aantal
`runs`optioneel	Aantal runs
`interval`optioneel	Pauze tussen runs, in minuten. Geheel getal: 10, 20, 30, 60

Antwoord

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

Bestelling met reacties

Apart besteltype: in plaats van een aantal stuurt u een lijst met reacties. Geschikt voor vermeldingen en eigen reacties.

Parameter	Beschrijving
`key`verplicht	Uw sleutel uit de API-instellingen
`action`verplicht	`add`
`service`verplicht	Pakket-ID
`link`verplicht	Link naar kanaal, stream of pagina
`comments`verplicht	Reacties, één per regel

Antwoord

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

Bestelstatus

Parameter	Beschrijving
`key`verplicht	Uw sleutel uit de API-instellingen
`action`verplicht	`status`
`order`verplicht	Bestel-ID

Antwoord

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

Status van meerdere bestellingen

Tot honderd bestellingen in één verzoek, in plaats van honderd losse.

Parameter	Beschrijving
`key`verplicht	Uw sleutel uit de API-instellingen
`action`verplicht	`status`
`orders`verplicht	ID’s met komma’s: `12,13,14`

Antwoord

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

Dienstenlijst

Geeft alle beschikbare diensten met prijzen terug. De taal van de namen komt uit de API-instellingen, prijzen altijd in dollars.

Parameter	Beschrijving
`key`verplicht	Uw sleutel uit de API-instellingen
`action`verplicht	`services`

Antwoord

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

Saldo

De eenvoudigste methode — handig om te controleren of de sleutel werkt.

Parameter	Beschrijving
`key`verplicht	Uw sleutel uit de API-instellingen
`action`verplicht	`balance`

Antwoord

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

Fouten

Bij een fout bevat het antwoord het veld error met een beschrijving. De HTTP-code blijft 200 — controleer de body van het antwoord, niet de verbindingsstatus.