REST API · Versión 1

Referencia de la API

Automatiza pedidos, recargas y verificaciones de estado hablando con Best SMM Panel | Real Services - SureSMM directamente. Cada solicitud es una simple POST con tu clave de API — las respuestas llegan en JSON limpio.

POST https://suresmm.com/api/v1
Respuesta JSON Autenticación por clave 120 solic./min
Primeros pasos

Autenticación

Cada llamada se autentica con tu clave de API personal. Consíguela en tu panel, en Cuenta → API, y envíala como el key parámetro en cada solicitud.

Parámetro Tipo Descripción Obligatorio
key string Tu clave de API única Obligatorio
action string La acción del endpoint — p. ej., services, add, status, refill, balance Obligatorio
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
GET /services

Lista de servicios

Devuelve el catálogo completo de servicios con tarifas en vivo, límites y compatibilidad con relleno/entrega gradual.

Parámetro Tipo Descripción
key string Tu clave API
action string "services"
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=services"
200 Respuesta
[
  {
    "service": 1,
    "name": "YouTube Livestream Viewers",
    "rate": "0.33000000",
    "min": 1000,
    "max": 200000,
    "category": "Live Stream",
    "refill": true,
    "dripfeed": true
  }
]
POST /add

Agregar pedido

Realiza un nuevo pedido para un servicio. Los campos opcionales de entrega gradual te permiten dividir la entrega en tandas.

Parámetro Tipo Descripción Obligatorio
key string Tu clave API Obligatorio
action string "add" Obligatorio
service integer ID del servicio Obligatorio
link string Enlace a la página Obligatorio
quantity integer Cantidad a entregar Obligatorio
runs integer Tandas a entregar Opcional
interval integer Intervalo en minutos Opcional
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://example.com/post" \
  -d "quantity=1000"
200 Respuesta
{
  "order": 1242
}
POST /status

Estado del pedido

Consulta el progreso de cualquier pedido — estado, recuento inicial y cantidad restante.

Parámetro Tipo Descripción
key string Tu clave API
action string "status"
order integer ID del pedido
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=1242"
200 Respuesta
{
  "status": "Pending",
  "start_count": "1000",
  "remains": "500",
  "currency": "USD"
}
Estados disponibles
Pendiente Procesando Completado Parcial Cancelado Reembolsado
POST /refill

Relleno

Solicita un relleno para un pedido elegible y luego consulta su estado de relleno hasta que se complete.

Crear relleno

Parámetro Tipo Descripción
key string Tu clave API
action string "refill"
order integer ID del pedido
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=refill" \
  -d "order=1242"
200 Respuesta
{
  "success": "Your order will be refilled asap. Thank you for your patience",
  "refill": 12345
}

Estado del relleno

Parámetro Tipo Descripción
key string Tu clave API
action string "refill_status"
refill integer ID del relleno
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=refill_status" \
  -d "refill=12345"
200 Respuesta
{
  "status": "Completed"
}
POST /balance

Saldo del usuario

Obtén el saldo actual de la cuenta y su moneda.

Parámetro Tipo Descripción
key string Tu clave API
action string "balance"
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
200 Respuesta
{
  "balance": "100.84292",
  "currency": "USD"
}
Referencia

Respuestas de error

Cuando una solicitud no es válida, la API devuelve un objeto JSON con un error mensaje. Los más comunes se muestran a continuación.

El campo action es obligatorio
El campo api key es obligatorio
Clave API inválida
Acción inválida
ID de servicio no válido
El campo de enlace es obligatorio
El campo de cantidad es obligatorio
Respeta el límite
Saldo insuficiente
El campo de pedido es obligatorio
ID de pedido no válido
El pedido no es elegible para reposición
Estructura del error
{
  "error": "Invalid api key"
}
Chatea con nosotros