API

Τεκμηρίωση API

Ένα αίτημα POST για όλα: παραγγελία, κατάσταση, λίστα υπηρεσιών, υπόλοιπο. Συμβατό με Perfect Panel και SmartPanel.

Διεύθυνσηhttps://stream-promotion.ru/api/v2

ΜέθοδοςPOST

ΜορφήJSON

ΝόμισμαUSDπροεπιλογή, αλλάζει από τις ρυθμίσεις

Αυτό είναι το API του καταστήματος. Ο διαμορφωτής θεατών έχει δικό του API: άλλη διεύθυνση και άλλος τρόπος εξουσιοδότησης. Το κλειδί όμως είναι το ίδιο.

Τρία λάθη που εμποδίζουν συχνότερα

Το αίτημα στάλθηκε με GET. Γίνεται δεκτό μόνο POST.
Οι παράμετροι μπήκαν στη διεύθυνση. Πρέπει να πηγαίνουν στο σώμα του αιτήματος.
Δεν ορίστηκε User-Agent. Σε δοκιμές με Postman ή curl δηλώστε τον ρητά.

Η ευθύνη για όσα στέλνετε μέσω API είναι δική σας. Διαβάστε την περιγραφή των μεθόδων πριν τη σύνδεση.

Πώς παίρνετε κλειδί

Συνδεθείτε στον λογαριασμό σας.
Ανοίξτε την ενότητα «Ρυθμίσεις API».
Αντιγράψτε το κλειδί και τη διεύθυνση, προσθέστε τα στο δικό σας panel.

Η λίστα υπηρεσιών έρχεται στη γλώσσα που έχει επιλεγεί στις ρυθμίσεις API. Το νόμισμα των τιμών επιλέγεται εκεί — προεπιλογή USD.

Γρήγορη εκκίνηση

Ελέγξτε τη σύνδεση με αίτημα υπολοίπου — είναι το απλούστερο και δεν δημιουργεί τίποτα.

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

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

Απάντηση

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

Μέθοδοι

Η μέθοδος επιλέγεται με την παράμετρο action. Το key είναι πάντα υποχρεωτικό.

Δημιουργία παραγγελίας

Η βασική μέθοδος. Τα runs και interval μοιράζουν την παράδοση: 7 εκτελέσεις ανά 1440 λεπτά απλώνουν την παραγγελία σε μία εβδομάδα.

Το σύνολο παραμέτρων εξαρτάται από τον τύπο υπηρεσίας — επιλέξτε τον από τη λίστα και ο πίνακας θα ενημερωθεί.

Παράμετρος	Περιγραφή
`key`υποχρεωτικό	Το κλειδί σας από τις ρυθμίσεις API
`action`υποχρεωτικό	`add`
`service`υποχρεωτικό	Αναγνωριστικό υπηρεσίας από τη λίστα
`link`υποχρεωτικό	Σύνδεσμος καναλιού, μετάδοσης ή σελίδας
`quantity`υποχρεωτικό	Ποσότητα
`runs`προαιρετικό	Αριθμός εκτελέσεων
`interval`προαιρετικό	Παύση ανάμεσα στις εκτελέσεις, σε λεπτά. Ακέραιος: 10, 20, 30, 60

Απάντηση

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

Παραγγελία με σχόλια

Ξεχωριστός τύπος: αντί για ποσότητα στέλνετε λίστα σχολίων. Κατάλληλο για αναφορές και προσαρμοσμένα σχόλια.

Παράμετρος	Περιγραφή
`key`υποχρεωτικό	Το κλειδί σας από τις ρυθμίσεις API
`action`υποχρεωτικό	`add`
`service`υποχρεωτικό	Αναγνωριστικό πακέτου
`link`υποχρεωτικό	Σύνδεσμος καναλιού, μετάδοσης ή σελίδας
`comments`υποχρεωτικό	Σχόλια, ένα ανά γραμμή

Απάντηση

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

Κατάσταση παραγγελίας

Παράμετρος	Περιγραφή
`key`υποχρεωτικό	Το κλειδί σας από τις ρυθμίσεις API
`action`υποχρεωτικό	`status`
`order`υποχρεωτικό	Αναγνωριστικό παραγγελίας

Απάντηση

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

Κατάσταση πολλών παραγγελιών

Έως εκατό παραγγελίες σε ένα αίτημα, αντί για εκατό ξεχωριστές κλήσεις.

Παράμετρος	Περιγραφή
`key`υποχρεωτικό	Το κλειδί σας από τις ρυθμίσεις API
`action`υποχρεωτικό	`status`
`orders`υποχρεωτικό	Αναγνωριστικά με κόμμα: `12,13,14`

Απάντηση

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

Λίστα υπηρεσιών

Επιστρέφει όλες τις διαθέσιμες υπηρεσίες με τιμές. Η γλώσσα των ονομάτων προκύπτει από τις ρυθμίσεις API, οι τιμές πάντα σε δολάρια.

Παράμετρος	Περιγραφή
`key`υποχρεωτικό	Το κλειδί σας από τις ρυθμίσεις API
`action`υποχρεωτικό	`services`

Απάντηση

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

Υπόλοιπο

Η απλούστερη μέθοδος — βολική για να ελέγξετε ότι το κλειδί δουλεύει.

Παράμετρος	Περιγραφή
`key`υποχρεωτικό	Το κλειδί σας από τις ρυθμίσεις API
`action`υποχρεωτικό	`balance`

Απάντηση

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

Σφάλματα

Σε αποτυχία η απάντηση περιέχει το πεδίο error με περιγραφή. Ο κωδικός HTTP παραμένει 200 — ελέγξτε το σώμα της απάντησης, όχι την κατάσταση σύνδεσης.