v2 API ドキュメント

レスポンス

{
  "balance": "100.8400",
  "currency": "USD"
}

レスポンス(配列)

[
  {
    "service": "svc_abc123",      // add の service に渡す ID
    "name": "Instagram Followers",
    "type": "Default",            // サービス種別
    "rate": "5.0000",             // 1000 単位あたりの価格 (USD)
    "min": "10",
    "max": "100000",
    "category": "Instagram",
    "refill": true,               // リフィル対応可否
    "cancel": true,               // キャンセル対応可否
    "dripfeed": false             // ドリップフィード対応可否
  }
]

有効かつ提供元が稼働中のサービスのみ返します。rate は SMM パネル慣例どおり「1000 件あたりの価格」です。

リクエスト例

curl -X POST https://demo.socialgoodworld.com/api/v2 \
  -d "key=smm_XXXX...&action=add&service=svc_abc123&link=https://instagram.com/p/...&quantity=1000"

レスポンス(成功)

{
  "order": "ord_abc123",   // この注文の ID
  "charge": "5.00",        // 引き落とし額 (USD)
  "currency": "USD"
}

残高は発注時に即座に引き落とされます。上流プロバイダが発注を拒否した場合は注文が Canceled になり、引き落とし額は自動で残高へ返金されます。残高不足のときは 402 { "error": "Not enough funds" } を返します。

レスポンス(単一: order 指定)

{
  "charge": "5.0000",
  "start_count": "1200",   // 配信開始時点のカウント
  "status": "In progress",
  "remains": "300",        // 残り配信数
  "currency": "USD"
}

レスポンス(複数: orders 指定)

{
  "ord_abc123": { "charge": "5.0000", "start_count": "1200", "status": "Completed", "remains": "0", "currency": "USD" },
  "ord_bad999": { "error": "Incorrect order ID" }
}

単一指定で注文が見つからない場合は 404 { "error": "Incorrect order ID" }。複数指定では HTTP 200 で、見つからない ID だけ { "error": "Incorrect order ID" } を返します。返却値はローカル DB の値で、上流との同期は sync-orders cron が定期的に行います。

レスポンス(単一)

{ "refill": "pending" }

レスポンス(複数)

[
  { "order": "ord_abc123", "refill": "pending" },
  { "order": "ord_def456", "error": "Refill not supported for this service" }
]

リフィルはフラグを立てるだけで、実際の上流呼び出しは sync-orders cron が非同期にディスパッチします。対象は refill 対応かつ Completed / Partial の注文に限られます。

レスポンス

{ "status": "Pending" }   // "Completed" | "Pending" | "Not Found"

Completed = リフィル実行済み、Pending = 要求受付済み(cron 待ち)、Not Found = リフィル要求なし。注文が見つからない場合は 404 { "error": "Incorrect order ID" }。

レスポンス(単一・複数とも配列)

[
  { "order": "ord_abc123", "cancel": "1" },
  { "order": "ord_def456", "error": "Order status not eligible" }
]

キャンセルもフラグを立てるだけで、上流呼び出しは sync-orders cron が処理します。キャンセルが確定すると未着分は残高へ返金されます。対象は cancel 対応かつ未完了(Awaiting / Pending / Processing / In progress)の注文です。