Documentación para desarrolladores

API de smmto.com

Integra nuestros servicios directamente en tu plataforma con nuestra potente REST API. Rápida, fiable y fácil de implementar. Crea tu herramienta de crecimiento o panel de revendedor hoy.

Tiempo de actividad 99.9%
Tiempo de respuesta <200ms
Volumen 50M+
Obtener clave API Ver en GitHub

1. Primeros pasos

Nuestra API se basa en principios REST. Usa códigos de respuesta HTTP estándar, autenticación y verbos. Todas las solicitudes se envían a la URL base y devuelven respuestas en JSON.

URL base: https://smmto.com/api/v2

2. Autenticación

Para autenticar tus solicitudes, incluye tu clave API única como parámetro `key` en cada solicitud. Puedes encontrarla en el panel de tu cuenta.

POST https://smmto.com/api/v2
Content-Type: application/json

{
  "key": "your-api-key-here",
  "action": "services"
}

Mantén tu clave API en secreto. No la compartas en repositorios públicos, código de cliente o documentación. Si se compromete, regenerala de inmediato.

3. Añadir pedido

POST /api/v2

Realiza un nuevo pedido de cualquier servicio de redes sociales disponible en nuestra plataforma.

Parámetro Tipo Obligatorio Descripción
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

Ejemplo de solicitud

{
  "key": "your-api-key",
  "action": "add",
  "service": 1,
  "link": "https://t.me/yourchannel",
  "quantity": 1000
}

Ejemplo de respuesta

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

4. Estado del pedido

POST /api/v2

Consulta el estado y el progreso de un pedido realizado anteriormente.

Parámetro Tipo Obligatorio Descripción
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. Pedidos múltiples

POST /api/v2

La eficiencia es clave. Usa el endpoint masivo para realizar hasta 100 pedidos en una sola llamada API.

{
  "key": "your-api-key",
  "action": "add_bulk",
  "orders": [
    { "service": 1, "link": "link_1", "quantity": 100 },
    { "service": 2, "link": "link_2", "quantity": 250 }
  ]
}

6. Cancel Order

POST /api/v2

Cancel a pending or in-progress order by order ID.

{
  "key": "your-api-key",
  "action": "cancel",
  "order": 23501
}

7. Refill Order

POST /api/v2

Request a refill for eligible orders that dropped below the guaranteed level.

{
  "key": "your-api-key",
  "action": "refill",
  "order": 23501
}

8. Services List

POST /api/v2

Retrieve the full list of available services, rates, min/max quantities, and metadata.

{
  "key": "your-api-key",
  "action": "services"
}

9. Códigos de error

La API usa códigos de estado HTTP estándar para indicar éxito o fallo.

Código Mensaje Descripción
400Invalid requestMissing or invalid parameters
401Invalid API keyAuthentication failed
404Service not foundInvalid service ID
429Rate limit exceededToo many requests
500Internal errorServer-side error

10. Rate Limits

API requests are limited to 100 requests per minute per API key. Exceeding this limit returns HTTP 429. Contact support for higher throughput on reseller plans.

11. SDKs y bibliotecas

12. Changelog

v2.0 — Unified REST endpoint at /api/v2 with bulk orders, refill status, and improved error responses.

Métodos de la API del panel

Service list

POST /api/v2 services
Parámetro Descripción
key Your API key
action services

Ejemplo de respuesta

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

Add order

POST /api/v2 add

Ejemplo de respuesta

{
    "order": 23501
}

Order status

POST /api/v2 status
Parámetro Descripción
key Your API key
action status
order Order ID

Ejemplo de respuesta

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

Multiple orders status

POST /api/v2 multi_status
Parámetro Descripción
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

Ejemplo de respuesta

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

Create refill

POST /api/v2 refill
Parámetro Descripción
key Your API key
action refill
order Order ID

Ejemplo de respuesta

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
Parámetro Descripción
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

Ejemplo de respuesta

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

Get refill status

POST /api/v2 refill_status
Parámetro Descripción
key Your API key
action refill_status
refill Refill ID

Ejemplo de respuesta

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
Parámetro Descripción
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

Ejemplo de respuesta

[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]

Create cancel

POST /api/v2 cancel
Parámetro Descripción
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

Ejemplo de respuesta

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]

User balance

POST /api/v2 balance
Parámetro Descripción
key Your API key
action balance

Ejemplo de respuesta

{
    "balance": "100.84292",
    "currency": "USD"
}
Ejemplo de código PHP
Chat en vivo Soporte 24/7