Entwicklerdokumentation

smmto.com API

Integrieren Sie unsere Services direkt in Ihre Plattform mit unserer leistungsstarken REST API. Schnell, zuverlässig und einfach umzusetzen. Erstellen Sie noch heute Ihr Wachstumstool oder Reseller-Panel.

Verfügbarkeit 99.9%
Antwortzeit <200ms
Volumen 50M+

1. Erste Schritte

Unsere API basiert auf REST-Prinzipien. Sie verwendet Standard-HTTP-Antwortcodes, Authentifizierung und Verben. Alle Anfragen gehen an die Basis-URL und liefern Antworten im JSON-Format.

Basis-URL: https://smmto.com/api/v2

2. Authentifizierung

Zur Authentifizierung Ihrer Anfragen müssen Sie Ihren eindeutigen API-Schlüssel als Parameter `key` in jeder Anfrage angeben. Den Schlüssel finden Sie im Account-Dashboard.

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

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

Halten Sie Ihren API-Schlüssel geheim. Teilen Sie ihn nicht in öffentlichen Repositories, Client-Code oder Dokumentation. Bei Kompromittierung sofort neu generieren.

3. Bestellung hinzufügen

POST /api/v2

Geben Sie eine neue Bestellung für jeden Social-Media-Service auf unserer Plattform auf.

Parameter Typ Erforderlich Beschreibung
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

Beispielanfrage

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

Beispielantwort

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

4. Bestellstatus

POST /api/v2

Prüfen Sie Status und Fortschritt einer zuvor aufgegebenen Bestellung.

Parameter Typ Erforderlich Beschreibung
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. Mehrere Bestellungen

POST /api/v2

Effizienz zählt. Nutzen Sie den Bulk-Endpunkt, um bis zu 100 Bestellungen in einem API-Aufruf aufzugeben.

{
  "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. Fehlercodes

Die API verwendet Standard-HTTP-Statuscodes, um Erfolg oder Fehler anzuzeigen.

Code Nachricht Beschreibung
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 & Bibliotheken

12. Changelog

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

Panel-API-Methoden

Service list

POST /api/v2 services
Parameter Beschreibung
key Your API key
action services

Beispielantwort

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

Beispielantwort

{
    "order": 23501
}

Order status

POST /api/v2 status
Parameter Beschreibung
key Your API key
action status
order Order ID

Beispielantwort

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

Multiple orders status

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

Beispielantwort

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

Beispielantwort

{
    "refill": "1"
}

Create multiple refill

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

Beispielantwort

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

Get refill status

POST /api/v2 refill_status
Parameter Beschreibung
key Your API key
action refill_status
refill Refill ID

Beispielantwort

{
    "status": "Completed"
}

Get multiple refill status

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

Beispielantwort

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

Create cancel

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

Beispielantwort

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

User balance

POST /api/v2 balance
Parameter Beschreibung
key Your API key
action balance

Beispielantwort

{
    "balance": "100.84292",
    "currency": "USD"
}
Beispiel-PHP-Code
Live-Chat 24/7 Support