API

Documentazione API

Una richiesta POST per tutto: ordine, stato, elenco servizi, saldo. Compatibile con Perfect Panel e SmartPanel.

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

MetodoPOST

FormatoJSON

ValutaUSDpredefinita, modificabile nelle impostazioni

Questa è l’API del negozio. Il configuratore di spettatori ha una propria API: indirizzo e autorizzazione diversi. La chiave però è la stessa.

Tre errori che bloccano più spesso

La richiesta è stata inviata con GET. Si accetta solo POST.
I parametri sono nell’URL. Vanno nel corpo della richiesta, non nella query.
Manca lo User-Agent. Nei test con Postman o curl indicalo esplicitamente.

Sei responsabile di ciò che invii tramite l’API. Leggi la descrizione dei metodi prima di collegarti.

Come ottenere la chiave

Accedi al tuo account.
Apri la sezione «Impostazioni API».
Copia la chiave e l’indirizzo, aggiungili al tuo pannello.

L’elenco servizi arriva nella lingua scelta nelle impostazioni API. La valuta dei prezzi si sceglie lì stesso — USD per impostazione predefinita.

Avvio rapido

Verifica la connessione con una richiesta di saldo: è la più semplice e non crea nulla.

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

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

Risposta

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

Metodi

Il metodo si sceglie con il parametro action. La key è sempre obbligatoria.

Creare un ordine

Il metodo principale. runs e interval ripartiscono la consegna: 7 esecuzioni a 1440 minuti di distanza distribuiscono l’ordine su una settimana.

Il set di parametri dipende dal tipo di servizio: sceglilo nell’elenco e la tabella si aggiornerà.

Parametro	Descrizione
`key`obbligatorio	La tua chiave dalle impostazioni API
`action`obbligatorio	`add`
`service`obbligatorio	ID del servizio dall’elenco
`link`obbligatorio	Link al canale, alla diretta o alla pagina
`quantity`obbligatorio	Quantità
`runs`facoltativo	Numero di esecuzioni
`interval`facoltativo	Pausa tra le esecuzioni, in minuti. Numero intero: 10, 20, 30, 60

Risposta

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

Ordine con commenti

Tipo di ordine a parte: invece della quantità si passa un elenco di commenti. Adatto a menzioni e commenti personalizzati.

Parametro	Descrizione
`key`obbligatorio	La tua chiave dalle impostazioni API
`action`obbligatorio	`add`
`service`obbligatorio	ID del pacchetto
`link`obbligatorio	Link al canale, alla diretta o alla pagina
`comments`obbligatorio	Commenti, uno per riga

Risposta

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

Stato dell’ordine

Parametro	Descrizione
`key`obbligatorio	La tua chiave dalle impostazioni API
`action`obbligatorio	`status`
`order`obbligatorio	ID dell’ordine

Risposta

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

Stato di più ordini

Fino a cento ordini in una richiesta, invece di cento chiamate separate.

Parametro	Descrizione
`key`obbligatorio	La tua chiave dalle impostazioni API
`action`obbligatorio	`status`
`orders`obbligatorio	ID separati da virgole: `12,13,14`

Risposta

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

Elenco servizi

Restituisce tutti i servizi disponibili con i prezzi. La lingua dei nomi viene dalle impostazioni API, i prezzi sono sempre in dollari.

Parametro	Descrizione
`key`obbligatorio	La tua chiave dalle impostazioni API
`action`obbligatorio	`services`

Risposta

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

Saldo

Il metodo più semplice: comodo per verificare che la chiave funzioni.

Parametro	Descrizione
`key`obbligatorio	La tua chiave dalle impostazioni API
`action`obbligatorio	`balance`

Risposta

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

Errori

In caso di errore la risposta contiene il campo error con la descrizione. Il codice HTTP resta 200: controlla il corpo della risposta, non lo stato della connessione.