開発者向けドキュメント

smmto.com API

強力な REST API でサービスをプラットフォームに直接統合。高速・信頼性・実装しやすい。今すぐ成長ツールやリセラーパネルを構築しましょう。

稼働率 99.9%
応答時間 <200ms
ボリューム 50M+
APIキーを取得 GitHubで見る

1. はじめに

当社のAPIはREST原則に基づいています。標準のHTTP応答コード、認証、動詞を使用します。すべてのリクエストはベースURLに送信し、JSON形式で応答します。

ベースURL： https://smmto.com/api/v2

2. 認証

リクエストを認証するには、一意のAPIキーを各リクエストの `key` パラメータとして含める必要があります。APIキーはアカウントダッシュボードで確認できます。

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

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

APIキーは秘密にしてください。公開リポジトリ、クライアント側コード、ドキュメントで共有しないでください。漏洩した場合はすぐに再発行してください。

3. 注文を追加

POST /api/v2

プラットフォームで利用可能な任意のソーシャルメディアサービスに新規注文を出します。

パラメータ 型 必須 説明
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

リクエスト例

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

レスポンス例

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

4. 注文ステータス

POST /api/v2

以前に出した注文のステータスと進捗を確認します。

パラメータ 型 必須 説明
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. 複数注文

POST /api/v2

効率が重要です。バルクエンドポイントを使い、1回のAPI呼び出しで最大100件の注文を出します。

{
  "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. エラーコード

APIは成功または失敗を示すために標準のHTTPステータスコードを使用します。

コード メッセージ 説明
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とライブラリ

12. Changelog

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

パネルAPIメソッド

Service list

POST /api/v2 services
パラメータ 説明
key Your API key
action services

レスポンス例

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

レスポンス例

{
    "order": 23501
}

Order status

POST /api/v2 status
パラメータ 説明
key Your API key
action status
order Order ID

レスポンス例

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

Multiple orders status

POST /api/v2 multi_status
パラメータ 説明
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

レスポンス例

{
    "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
パラメータ 説明
key Your API key
action refill
order Order ID

レスポンス例

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
パラメータ 説明
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

レスポンス例

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

Get refill status

POST /api/v2 refill_status
パラメータ 説明
key Your API key
action refill_status
refill Refill ID

レスポンス例

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
パラメータ 説明
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

レスポンス例

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

Create cancel

POST /api/v2 cancel
パラメータ 説明
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

レスポンス例

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

User balance

POST /api/v2 balance
パラメータ 説明
key Your API key
action balance

レスポンス例

{
    "balance": "100.84292",
    "currency": "USD"
}
PHPコード例
ライブチャット 24時間サポート