Documentation développeur

API smmto.com

Intégrez nos services directement à votre plateforme avec notre puissante REST API. Rapide, fiable et facile à mettre en œuvre. Créez votre outil de croissance ou panneau revendeur dès aujourd’hui.

Disponibilité 99.9%
Temps de réponse <200ms
Volume 50M+

1. Premiers pas

Notre API repose sur les principes REST. Elle utilise des codes de réponse HTTP standard, l’authentification et des verbes. Toutes les requêtes doivent être envoyées à l’URL de base et renvoient des réponses au format JSON.

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

2. Authentification

Pour authentifier vos requêtes, incluez votre clé API unique comme paramètre `key` dans chaque requête. Vous trouverez votre clé dans le tableau de bord du compte.

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

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

Gardez votre clé API secrète. Ne la partagez pas dans des dépôts publics, du code côté client ou de la documentation. Si elle est compromise, régénérez-la immédiatement.

3. Ajouter une commande

POST /api/v2

Passez une nouvelle commande pour tout service de réseaux sociaux disponible sur notre plateforme.

Paramètre Type Obligatoire Description
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

Exemple de requête

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

Exemple de réponse

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

4. Statut de commande

POST /api/v2

Vérifiez le statut et la progression d’une commande déjà passée.

Paramètre Type Obligatoire Description
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. Commandes multiples

POST /api/v2

L’efficacité est essentielle. Utilisez l’endpoint bulk pour passer jusqu’à 100 commandes en un seul appel 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. Codes d’erreur

L’API utilise des codes de statut HTTP standard pour indiquer le succès ou l’échec.

Code Message Description
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 et bibliothèques

12. Changelog

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

Méthodes Panel API

Service list

POST /api/v2 services
Paramètre Description
key Your API key
action services

Exemple de réponse

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

Exemple de réponse

{
    "order": 23501
}

Order status

POST /api/v2 status
Paramètre Description
key Your API key
action status
order Order ID

Exemple de réponse

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

Multiple orders status

POST /api/v2 multi_status
Paramètre Description
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

Exemple de réponse

{
    "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
Paramètre Description
key Your API key
action refill
order Order ID

Exemple de réponse

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
Paramètre Description
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

Exemple de réponse

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

Get refill status

POST /api/v2 refill_status
Paramètre Description
key Your API key
action refill_status
refill Refill ID

Exemple de réponse

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
Paramètre Description
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

Exemple de réponse

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

Create cancel

POST /api/v2 cancel
Paramètre Description
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

Exemple de réponse

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

User balance

POST /api/v2 balance
Paramètre Description
key Your API key
action balance

Exemple de réponse

{
    "balance": "100.84292",
    "currency": "USD"
}
Exemple de code PHP
Chat en direct Support 24/7