Dokumentacja dla deweloperów

API smmto.com

Zintegruj nasze usługi bezpośrednio ze swoją platformą dzięki potężnemu REST API. Szybko, niezawodnie i łatwo we wdrożeniu. Zbuduj dziś własne narzędzie wzrostu lub panel resellera.

Dostępność 99.9%
Czas odpowiedzi <200ms
Wolumen 50M+
Uzyskaj klucz API Zobacz na GitHub

1. Pierwsze kroki

Nasze API opiera się na zasadach REST. Używa standardowych kodów odpowiedzi HTTP, uwierzytelniania i czasowników. Wszystkie żądania należy wysyłać na bazowy URL; odpowiedzi wracają w formacie JSON.

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

2. Uwierzytelnianie

Aby uwierzytelnić żądania, dołącz unikalny klucz API jako parametr `key` w każdym żądaniu. Klucz znajdziesz w panelu konta.

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

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

Trzymaj klucz API w tajemnicy. Nie udostępniaj go w publicznych repozytoriach, kodzie klienta ani dokumentacji. W razie kompromitacji wygeneruj go natychmiast ponownie.

3. Dodaj zamówienie

POST /api/v2

Złóż nowe zamówienie na dowolną usługę social media dostępną na naszej platformie.

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

Przykład żądania

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

Przykład odpowiedzi

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

4. Status zamówienia

POST /api/v2

Sprawdź status i postęp wcześniej złożonego zamówienia.

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

5. Wiele zamówień

POST /api/v2

Efektywność ma znaczenie. Użyj endpointu bulk, aby złożyć do 100 zamówień w jednym wywołaniu 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. Kody błędów

API używa standardowych kodów statusu HTTP do oznaczania sukcesu lub błędu.

Kod Wiadomość Opis
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 i biblioteki

12. Changelog

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

Metody Panel API

Service list

POST /api/v2 services
Parametr Opis
key Your API key
action services

Przykład odpowiedzi

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

Przykład odpowiedzi

{
    "order": 23501
}

Order status

POST /api/v2 status
Parametr Opis
key Your API key
action status
order Order ID

Przykład odpowiedzi

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

Multiple orders status

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

Przykład odpowiedzi

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

Przykład odpowiedzi

{
    "refill": "1"
}

Create multiple refill

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

Przykład odpowiedzi

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

Get refill status

POST /api/v2 refill_status
Parametr Opis
key Your API key
action refill_status
refill Refill ID

Przykład odpowiedzi

{
    "status": "Completed"
}

Get multiple refill status

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

Przykład odpowiedzi

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

Create cancel

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

Przykład odpowiedzi

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

User balance

POST /api/v2 balance
Parametr Opis
key Your API key
action balance

Przykład odpowiedzi

{
    "balance": "100.84292",
    "currency": "USD"
}
Przykładowy kod PHP
Czat na żywo Wsparcie 24/7