API

Documentación de la API

Una petición POST para todo: pedido, estado, lista de servicios, saldo. Compatible con Perfect Panel y SmartPanel.

Direcciónhttps://stream-promotion.ru/api/v2

MétodoPOST

FormatoJSON

MonedaUSDpor defecto, se cambia en los ajustes

Esta es la API de la tienda. El configurador de espectadores tiene su propia API: otra dirección y otro método de autorización. La clave, en cambio, es la misma.

Tres errores que fallan más a menudo

La petición se envió con GET. Solo se acepta POST.
Los parámetros van en la URL. Deben ir en el cuerpo de la petición, no en la query.
Falta el User-Agent. Al probar con Postman o curl, indícalo explícitamente.

Eres responsable de lo que envías por la API. Lee la descripción de los métodos antes de conectar.

Cómo obtener la clave

Entra en tu cuenta.
Abre la sección «Ajustes de API».
Copia la clave y la dirección, añádelas a tu panel.

La lista de servicios llega en el idioma elegido en los ajustes de API. La moneda de los precios se elige ahí mismo: USD por defecto.

Inicio rápido

Comprueba la conexión con una petición de saldo: es la más simple y no crea nada.

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

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

Respuesta

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

Métodos

El método se elige con el parámetro action. La key es siempre obligatoria.

Crear pedido

El método principal. runs e interval reparten la entrega: 7 lanzamientos con 1440 minutos de intervalo estiran el pedido a una semana.

El conjunto de parámetros depende del tipo de servicio: elígelo en la lista y la tabla se actualizará.

Parámetro	Descripción
`key`obligatorio	Tu clave de los ajustes de API
`action`obligatorio	`add`
`service`obligatorio	Identificador del servicio de la lista
`link`obligatorio	Enlace al canal, directo o página
`quantity`obligatorio	Cantidad
`runs`opcional	Número de lanzamientos
`interval`opcional	Pausa entre lanzamientos, en minutos. Número entero: 10, 20, 30, 60

Respuesta

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

Pedido con comentarios

Tipo de pedido aparte: en vez de cantidad se envía una lista de comentarios. Sirve para menciones y comentarios personalizados.

Parámetro	Descripción
`key`obligatorio	Tu clave de los ajustes de API
`action`obligatorio	`add`
`service`obligatorio	Identificador del paquete
`link`obligatorio	Enlace al canal, directo o página
`comments`obligatorio	Comentarios, uno por línea

Respuesta

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

Estado del pedido

Parámetro	Descripción
`key`obligatorio	Tu clave de los ajustes de API
`action`obligatorio	`status`
`order`obligatorio	Identificador del pedido

Respuesta

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

Estado de varios pedidos

Hasta cien pedidos en una petición, en vez de cien llamadas sueltas.

Parámetro	Descripción
`key`obligatorio	Tu clave de los ajustes de API
`action`obligatorio	`status`
`orders`obligatorio	Identificadores separados por comas: `12,13,14`

Respuesta

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

Lista de servicios

Devuelve todos los servicios disponibles con precios. El idioma de los nombres viene de los ajustes de API; los precios siempre en dólares.

Parámetro	Descripción
`key`obligatorio	Tu clave de los ajustes de API
`action`obligatorio	`services`

Respuesta

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

Saldo

El método más simple: cómodo para comprobar que la clave funciona.

Parámetro	Descripción
`key`obligatorio	Tu clave de los ajustes de API
`action`obligatorio	`balance`

Respuesta

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

Errores

Si falla, la respuesta trae el campo error con la descripción. El código HTTP sigue siendo 200: revisa el cuerpo de la respuesta, no el estado de la conexión.