Panel SMM API: documentación

¿Qué es la API de un panel SMM?

La API de un panel SMM permite que un programa obtenga la lista de servicios, haga pedidos y consulte el estado de los pedidos y el saldo sin pasar por la web. 4SNS PLUS admite el formato estándar de API v2 para paneles SMM que usan muchos paneles y bots, así que el código que ya conectaste a otro panel funciona al instante con solo cambiar la URL y la clave.

Los precios y el saldo de la API son los mismos que en la web. El rate de la respuesta de services equivale al precio por cada 1,000 (dólares estadounidenses) de la lista de precios, y los pedidos hechos con add se descuentan de tu saldo igual que los pedidos web y también aparecen en el historial de pedidos de tu panel. Los importes devueltos por pedidos cancelados o parciales vuelven al mismo saldo.

Datos básicos

Ejemplo de solicitud

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

¿Cómo consigo una clave API?

En cuanto tu primera recarga se acredite en tu saldo, puedes crear una clave API desde el menú Clave API de tu panel. La clave se muestra una sola vez al crearla, así que guárdala en un lugar seguro. Al crear una clave nueva, la anterior se desactiva al instante.

La clave es distinta del token de tu cuenta. Pon solo la clave API en tu bot o servidor, nunca el token de tu cuenta. Si crees que tu clave quedó expuesta, simplemente crea una nueva en la pantalla de Clave API.

Lista de servicios (services)

Devuelve todos los servicios que puedes pedir. rate es el precio por cada 1,000 (USD) y, cuando type es Package, es el precio de un paquete. Cuando type es Custom Comments, envías una lista de comentarios en lugar de una cantidad. category es el nombre de la plataforma más el nombre del grupo.

Ejemplo de respuesta

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

Crear un pedido (add)

Crea un pedido y descuenta el importe de tu saldo. El importe es el precio por cada 1,000 multiplicado por la cantidad; en Package es el precio del paquete y en Custom Comments la cantidad es el número de líneas de comentarios. Los pedidos están disponibles en cuentas cuya primera recarga ya está acreditada. El valor order de la respuesta es el ID de tu pedido.

Ejemplo de respuesta

{
  "order": 31877
}

Estado del pedido (status)

El estado de un pedido. charge es el importe realmente pagado después de reembolsos (USD, 6 decimales), start_count es el conteo al empezar el pedido y remains es la cantidad que aún no se ha entregado.

Ejemplo de respuesta

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

Estado de varios pedidos (status, orders)

Consulta hasta 100 pedidos a la vez, con los ID de pedido separados por comas. Los ID que no existen o no son de tu cuenta reciben un error en su lugar.

Ejemplo de respuesta

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Solicitar una reposición (refill)

Para un pedido de un servicio con periodo de reposición que terminó como Completed o Partial, solicítala dentro del periodo de reposición contado desde que terminó. Cada pedido puede tener una solicitud abierta, con 24 horas entre solicitudes.

Ejemplo de respuesta

{
  "refill": 512
}

Estado de la reposición (refill_status)

El estado de una solicitud de reposición.

Ejemplo de respuesta

{
  "status": "Completed"
}

Saldo (balance)

Tu saldo (USD, 6 decimales).

Ejemplo de respuesta

{
  "balance": "84.120000",
  "currency": "USD"
}

Valores de estado del pedido

Valores de estado de la reposición

Mensajes de error

Los errores llegan como JSON con un campo error en una respuesta HTTP 200. En tu código, comprueba primero el campo error.

{
  "error": "Not enough funds on balance"
}

¿Cómo conecto la API de un panel SMM a un bot de Telegram?