Documentazione per sviluppatori

API smmto.com

Integra i nostri servizi direttamente nella tua piattaforma con la potente REST API. Veloce, affidabile e facile da implementare. Crea oggi il tuo strumento di crescita o pannello rivenditore.

Uptime 99.9%
Tempo di risposta <200ms
Volume 50M+
Ottieni chiave API Vedi su GitHub

1. Per iniziare

La nostra API si basa sui principi REST. Usa codici di risposta HTTP standard, autenticazione e verbi. Tutte le richieste vanno all’URL di base e restituiscono risposte in formato JSON.

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

2. Autenticazione

Per autenticare le richieste, includi la tua chiave API univoca come parametro `key` in ogni richiesta. Puoi trovare la chiave nella dashboard dell’account.

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

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

Mantieni segreta la chiave API. Non condividerla in repository pubblici, codice client o documentazione. Se compromessa, rigenerala subito.

3. Aggiungi ordine

POST /api/v2

Effettua un nuovo ordine per qualsiasi servizio social disponibile sulla nostra piattaforma.

Parametro Tipo Obbligatorio Descrizione
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

Esempio di richiesta

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

Esempio di risposta

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

4. Stato ordine

POST /api/v2

Controlla lo stato e l’avanzamento di un ordine già effettuato.

Parametro Tipo Obbligatorio Descrizione
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. Ordini multipli

POST /api/v2

L’efficienza conta. Usa l’endpoint bulk per effettuare fino a 100 ordini in una sola chiamata 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. Codici di errore

L’API usa codici di stato HTTP standard per indicare successo o fallimento.

Codice Messaggio Descrizione
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. SDK e librerie

12. Changelog

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

Metodi Panel API

Service list

POST /api/v2 services
Parametro Descrizione
key Your API key
action services

Esempio di risposta

[
    {
        "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

Esempio di risposta

{
    "order": 23501
}

Order status

POST /api/v2 status
Parametro Descrizione
key Your API key
action status
order Order ID

Esempio di risposta

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

Multiple orders status

POST /api/v2 multi_status
Parametro Descrizione
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

Esempio di risposta

{
    "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
Parametro Descrizione
key Your API key
action refill
order Order ID

Esempio di risposta

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
Parametro Descrizione
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

Esempio di risposta

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

Get refill status

POST /api/v2 refill_status
Parametro Descrizione
key Your API key
action refill_status
refill Refill ID

Esempio di risposta

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
Parametro Descrizione
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

Esempio di risposta

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

Create cancel

POST /api/v2 cancel
Parametro Descrizione
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

Esempio di risposta

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

User balance

POST /api/v2 balance
Parametro Descrizione
key Your API key
action balance

Esempio di risposta

{
    "balance": "100.84292",
    "currency": "USD"
}
Esempio di codice PHP
Chat dal vivo Supporto 24/7