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.
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.
https://smmto.com/api/v2
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.
Passez une nouvelle commande pour tout service de réseaux sociaux disponible sur notre plateforme.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| key | string | Yes | Your unique API key |
| action | string | Yes | "add" |
| service | integer | Yes | Service ID (from Services List) |
| link | string | Yes | Target URL (e.g. Channel link) |
| quantity | integer | Yes | Total 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"
}
Vérifiez le statut et la progression d’une commande déjà passée.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| key | string | Yes | Your API key |
| action | string | Yes | "status" |
| order | integer | Yes | The ID of the order |
{
"charge": "0.5000",
"start_count": "1200",
"status": "In Progress",
"remains": "450",
"currency": "USD"
}
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 }
]
}
Cancel a pending or in-progress order by order ID.
{
"key": "your-api-key",
"action": "cancel",
"order": 23501
}
Request a refill for eligible orders that dropped below the guaranteed level.
{
"key": "your-api-key",
"action": "refill",
"order": 23501
}
Retrieve the full list of available services, rates, min/max quantities, and metadata.
{
"key": "your-api-key",
"action": "services"
}
L’API utilise des codes de statut HTTP standard pour indiquer le succès ou l’échec.
| Code | Message | Description |
|---|---|---|
| 400 | Invalid request | Missing or invalid parameters |
| 401 | Invalid API key | Authentication failed |
| 404 | Service not found | Invalid service ID |
| 429 | Rate limit exceeded | Too many requests |
| 500 | Internal error | Server-side error |
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.
v2.0 — Unified REST endpoint at /api/v2 with bulk orders, refill status, and improved error responses.
| 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
}
]
Exemple de réponse
{
"order": 23501
}
| 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"
}
| 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"
}
}
| Paramètre | Description |
|---|---|
key |
Your API key |
action |
refill |
order |
Order ID |
Exemple de réponse
{
"refill": "1"
}
| 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"
}
}
]
| Paramètre | Description |
|---|---|
key |
Your API key |
action |
refill_status |
refill |
Refill ID |
Exemple de réponse
{
"status": "Completed"
}
| 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"
}
}
]
| 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
}
]
| Paramètre | Description |
|---|---|
key |
Your API key |
action |
balance |
Exemple de réponse
{
"balance": "100.84292",
"currency": "USD"
}