API ドキュメント

APIキーを取得するにはログインしてください

お使いの API キー

読み込み中...

テストAPI

アクションを選択し、パラメータを入力してリクエストを送信します。ログインすると、APIキーが自動的に読み込まれます。

APIキー

言語（オプション）

アクション

Request command

アクションやパラメータを変更すると自動的に更新されます。

curl -X POST "https://hstockplus.net/api/v2" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=categories"

APIエンドポイント

https://hstockplus.net/api/v2

すべてのAPIリクエストは、このエンドポイントに対してHTTP POSTで送信する必要があります。

重要 — 商品画像URL（imageUrl）

Media CDNが有効な場合、サービス一覧、商品一覧、サブカテゴリ情報のレスポンス内のimageUrlフィールドはCDNドメイン（https://cdn.hstockplus.org/...）を使用します。これらの絶対URLをアプリで直接使用してください — hstockplus.comやhstockplus.netに置き換えないでください。

https://cdn.hstockplus.org/uploads/products/gmail.webp

オプションの言語（lang）

オプション。対象言語コード。以下にリストされているサポート対象コードのいずれかを使用します。設定されていてen以外の場合、翻訳可能なフィールドはその言語で返されます。翻訳がまだ利用できない場合、APIは英語を返します。

サポート対象言語コード

en(デフォルト — langを省略するか、enを使用)zhdejapt-BRurbn-BD

langパラメータにはこれらの正確な値を使用してください。エイリアス：jpはjaとして受け入れられます。

読み取りアクションでサポート： categories, subcategory_info, services, products, inventory (（サブ製品名）), sms_projects, そして sms_countries. langを省略するか、英語の場合はenを使用します。

サービス/製品のカテゴリおよびサブカテゴリフィルタパラメータは、langが設定されている場合でも、常に正規の英語名を使用します。

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

カテゴリを取得

すべてのカテゴリと各カテゴリのサブカテゴリを取得します。これらの値を使用して、サービス一覧をカテゴリまたはサブカテゴリでフィルタリングします。

パラメータ	説明	必須
key	お使いの API キー	はい
action	categories	はい
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories" \
  -d "lang=zh"

例の返信：

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

サブカテゴリ情報

subcategoryIdでサブカテゴリの詳細を取得します（親カテゴリを含む）。Products Listの行からsubcategoryIdを使用します。

パラメータ	説明	必須
key	お使いの API キー	はい
action	subcategory_info	はい
subcategoryId	Products ListからのサブカテゴリID	はい
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=subcategory_info" \
  -d "subcategoryId=674a1f77bcf86cd799439099" \
  -d "lang=zh"

例の返信：

{
  "subcategoryId": "674a1f77bcf86cd799439099",
  "name": "Gmail",
  "slug": "gmail",
  "imageUrl": "https://cdn.hstockplus.org/uploads/subcategories/gmail.webp",
  "description": "Verified Gmail accounts",
  "category": {
    "categoryId": "674a1f77bcf86cd799439088",
    "name": "Email Accounts",
    "slug": "email-accounts"
  }
}

ショップ一覧

アクティブなショップを基本情報、商品数、レビュー評価とともに一覧表示します。プライバシーのため、ショップ名はマスクされます。

パラメータ	説明	必須
key	お使いの API キー	はい
action	shops	はい
page	Page number (default 1).	No
limit	Items per page (default 20).	No

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

ページネーションあり：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops" \
  -d "page=1" \
  -d "limit=20"

クーポン一覧

現在使用できるすべてのショップのクーポンコードを、それぞれの条件とともに一覧表示します。コードは action=add の coupon に渡してください。お客様のアカウント専用に作成されたコード（チケットで依頼した大口価格の見積もりなど）も含まれ、private と表示されます。

パラメータ	説明	必須
key	お使いの API キー	はい
action	coupons	はい
shop	このショップのクーポンのみ（action=shops の shopId）。	No

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=coupons"

例の返信：

{
  "coupons": [
    {
      "code": "SAVE10",
      "type": "percentage",
      "value": 10,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "shop",
      "minPurchase": 20,
      "remainingUses": 87,
      "expiresAt": "2026-11-30T23:59:59.000Z"
    },
    {
      "code": "BULK500",
      "type": "percentage",
      "value": 5,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "services",
      "services": [110469, 110470],
      "minQuantity": 100,
      "quantityTiers": [
        { "minQuantity": 100, "value": 5 },
        { "minQuantity": 500, "value": 12 }
      ],
      "maxUsesPerUser": 1,
      "remainingUses": 40
    }
  ],
  "total": 2
}

項目	意味
type / value	percentage は value が割引率（%）、fixed は value が注文から値引きされる USD 額です。quantityTiers がある場合、value は最も低い段階の値です。
appliesTo	shop はそのショップのすべての商品が対象、services は services に挙げたサービス番号の商品のみが対象です。ショップクーポンはグロース（SMM）サービスには適用されません。
minPurchase	割引前の注文合計がこの USD 額以上である必要があります。
minQuantity	注文数量はこの値以上である必要があります。
quantityTiers	数量が多いほど割引率が高くなり、購入数量が到達した最上位の段階が適用されます。
maxDiscount	クーポンで 1 件の注文から値引きされる最大額（USD、上限がある場合のみ）。
maxUsesPerUser	1 つのアカウントがコードを使用できる回数（上限がある場合のみ）。
remainingUses	全購入者を通じた残り使用回数。
expiresAt	この日時を過ぎるとコードは使えなくなります（有効期限がない場合は省略）。
private	コードがお客様のアカウント専用に作成された場合は true。

クーポンは、リセラー割引を差し引いた後の金額から値引きされます。クーポンに該当する条件がない場合、任意項目は省略されます。

製品一覧

マーケットプレイスの商品のみを表示（SMMサービスは除く）。フィールドは「Services List」の商品行と同じで、id（商品エンティティID）、service（わかりやすいサービス番号）、description、imageUrlを含みます。オプションのproductIdsは、指定された商品のみを返します（リスト内のわかりやすいサービス番号や商品エンティティIDをカンマ区切りまたはJSON配列で指定、最大100件）。オプションのsort=soldは、有料注文ユニット数の降順（売れ筋順）で結果を並べ替えます。

パラメータ	説明	必須
key	お使いの API キー	はい
action	products	はい
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	カテゴリ名（Get Categories で取得）で絞り込みます。このカテゴリの商品のみを返します。	No
subcategory	サブカテゴリ名（Get Categories で取得）で絞り込みます。このサブカテゴリの商品のみを返します。	No
shopId	ショップ ID（Shops List で取得）で絞り込みます。そのショップの商品のみを返します。	No
productIds	Optional list of product IDs (service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns only those products (max 100).	No
isRecommended	オプション。trueに設定すると、isRecommended === trueの製品のみが返されます。	No
sort	任意。sold = 支払い済み注文ユニット数の降順でソート（売れ筋順）。省略時はデフォルトのキャッシュ順を維持。	No
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products"

製品IDでフィルタリング：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "productIds=2,5,9"

ページネーションあり：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "page=1" \
  -d "limit=50"

カテゴリまたはサブカテゴリでフィルタリング:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

サブカテゴリのベストセラー：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Twitter/X" \
  -d "sort=sold" \
  -d "page=1" \
  -d "limit=10"

おすすめ製品のみ：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "isRecommended=true"

サービス一覧

すべての利用可能なサービスをオプションのページネーション付きで取得します。各行には、id（エンティティID）、service（フレンドリーサービス番号）、stock、およびentityType（smmまたはproduct）が含まれます。オプションのentityTypeは、product行のみまたはsmm行のみを返します。オプションのカテゴリとサブカテゴリパラメータを使用すると、そのカテゴリまたはサブカテゴリ（カテゴリ取得APIからの値）のサービスのみを返します。オプションのshopIdは、そのショップ（ショップ一覧のshopIdを使用）の製品とサービスのみを返します。オプションのproductIdsは、一致する行のみを返します（フレンドリーサービス番号および/またはエンティティID；製品またはSMM行に一致）。action=productsを使用すると、製品のみにフィルタリングします。

パラメータ	説明	必須
key	お使いの API キー	はい
action	services	はい
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	カテゴリ名（Get Categories で取得）で絞り込みます。このカテゴリのサービスのみを返します。	No
subcategory	サブカテゴリ名（Get Categories で取得）で絞り込みます。このサブカテゴリのサービスのみを返します。	No
shopId	ショップ ID（Shops List で取得）で絞り込みます。そのショップの商品と SMM サービスのみを返します。	No
entityType	オプションのフィルター：productまたはsmm。マーケットプレイス製品のみ、またはSMMサービスのみを返します。	No
productIds	ID の任意リスト（わかりやすいサービス番号やエンティティ ID）。カンマ区切り、JSON 配列、または繰り返しフィールドで指定します。一致する商品または SMM の行を返します。商品のみが必要な場合は action=products を使用してください。	No
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

ページネーションあり：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

カテゴリまたはサブカテゴリでフィルタリング:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

エンティティタイプでフィルター：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "entityType=product"

例の返信：

{
  "services": [
    {
      "id": "507f1f77bcf86cd799439011",
      "service": 1,
      "name": "Instagram Followers",
      "type": "Default",
      "category": "Instagram",
      "rate": "0.50",
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "stock": 10000,
      "entityType": "smm",
      "autoDelivery": true
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "service": 2,
      "name": "Gmail Account - USA",
      "type": "Default",
      "category": "Accounts-Email",
      "rate": "25.00",
      "min": 1,
      "max": 50,
      "refill": false,
      "cancel": false,
      "stock": 50,
      "entityType": "product",
      "autoDelivery": true,
      "description": "Verified Gmail account with recovery email",
      "imageUrl": "https://cdn.hstockplus.org/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099",
      "sold": 5300,
      "sellerRating": 4.0,
      "sellerReviewCount": 30,
      "returningBuyerRate": 0.52,
      "warrantyHours": 12
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

各行にはid（エンティティID）、service（注文用のフレンドリーなサービス番号）、stock、entityType（smmまたはproduct）、autoDeliveryが含まれます。製品行にはdescription、imageUrl、isRecommended、subcategoryIdも含まれます。limitが0または省略された場合、すべてのサービスが返され、page/limitは合計と等しくなります。

商品の行には、商品ページに表示される数値も含まれます。service は商品番号（ページ上では #48071）、sellerRating と sellerReviewCount は販売者の星評価とレビュー件数、returningBuyerRate は販売者のリピート購入者の割合（0.52 = 52%）、sold は販売数、warrantyHours は納品時から数えたアフターサービス期間（時間、0 = アフターサービスなし）です。販売者に評価がない場合や購入者が少なすぎる場合、sellerRating、sellerReviewCount、returningBuyerRate は省略されます。

在庫を確認

サービス ID（サービス一覧と同じ ID）から現在の在庫と利用可否を取得します。マーケットプレイス商品の場合、JSON には subproducts が含まれます。これは有効なバリエーションの配列で、それぞれに subproductId、name、stock（そのバリエーションの表示用在庫）、独自の価格と注文制限（available、rate、min、max、固定パックで販売されるオプションの packs）が含まれます。

パラメータ	説明	必須
key	お使いの API キー	はい
action	inventory	はい
service	サービス ID（サービス一覧から取得）	はい
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

レスポンス例（SMM）：

{
  "service": 1,
  "stock": 10000,
  "available": true,
  "rate": "0.5000",
  "entityType": "smm",
  "autoDelivery": true
}

レスポンス例（product）：

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "rate": "25.0000",
  "min": 1,
  "max": 42,
  "entityType": "product",
  "autoDelivery": true,
  "subproducts": [
    { "subproductId": "674a1f77bcf86cd799439011", "name": "1 Month", "stock": 42, "available": true, "rate": "25.0000", "min": 1, "max": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0, "available": false, "rate": "60.0000", "min": 1, "max": 0 },
    {
      "subproductId": "674a1f77bcf86cd799439013", "name": "Pack", "stock": 500, "available": true, "rate": "0.0190", "min": 100, "max": 100,
      "packs": [
        { "quantity": 100, "price": "1.9000", "discountPercent": 5 },
        { "quantity": 500, "price": "9.0000", "discountPercent": 10 }
      ]
    }
  ],
  "warrantyHours": 24
}

レスポンスには、レート（単価、サービス一覧と同じ文字列形式）、entityType（smmまたはproduct）、およびautoDelivery（true = 自動配送、false = サプライヤーが手動で対応）が含まれます。製品サービスの場合、minとmaxはサービス一覧のプライマリサブ製品行と一致します。そのサブ製品が注文を処理できない場合、プラットフォームは別のサブ製品を選択し、その単価を請求する場合があります。subproducts配列には、表示在庫を持つすべてのアクティブなバリアントがリストされます。SMM在庫レスポンスではsubproductsは省略されます。

各サブ商品には独自の rate、min、max があります。これは、その subproductId を指定したときに加算される単価と数量範囲で、アカウントのリセラー割引を適用する前の金額です。固定パックで販売されるオプションでは、packs に在庫のある各パック（quantity、合計価格、discountPercent）が一覧表示され、そのいずれかの数量で注文する必要があります。この場合、rate、min、max は最小のパックを表します。

warrantyHours (products only) is the product's after-sales window in hours counted from delivery, the same figure as in the services list; 0 means no after-sales.

注文を追加

Place a standard order with link and quantity. Link: for SMM services (e.g. followers, likes) — required, use the URL to the content (e.g. Instagram post); for product orders (e.g. accounts) — optional, if empty the system uses your account email for delivery. For products with multiple options (Select Option on the website), pass subproductId (from action=inventory) to choose which option to order — otherwise the default option is used.

パラメータ	説明	必須
key	お使いの API キー	はい
action	add	はい
service	サービスID	はい
link	リンク: SMM 注文（フォロワー、いいね、コメントなど）では必須で、コンテンツの URL またはリンク（Instagram の投稿 URL など）を指定します。商品注文（アカウントなど）では任意で、納品先メールまたは参照情報を指定します。空の場合は、ご登録のアカウントのメールが使用されます。	No
quantity	注文数量	はい
subproductId	商品のみ: デフォルトではなく特定のオプション（Select Option のバリエーション）を選択します。このサービスについて action=inventory が返す subproductId の値を使用してください。任意。グロース/SMM サービスでは使用しません。	No
coupon	クーポンコード（action=coupons またはショップページから取得）。任意。リセラー割引に上乗せして適用され、条件はウェブサイトのチェックアウトと同じです。コードが使用できない場合、注文は行われず、エラーに理由が表示されます。	No

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

# Product with multiple options: pick the subproductId from action=inventory
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=1" \
  -d "subproductId=674a1f77bcf86cd799439012"

# With a coupon code from action=coupons
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=10" \
  -d "coupon=SAVE10"

例の返信：

{
  "order": 23501,
  "entityType": "product",
  "charge": "22.5000",
  "couponDiscount": "2.5000",
  "warrantyHours": 24
}

charge is what was taken from your balance. couponDiscount is present only when a coupon was applied. warrantyHours (products only) is the after-sales window in hours counted from delivery, 0 = no after-sales; action=status returns the exact end time as warranty_expires_at.

注文状況

注文のステータスを取得します。

パラメータ	説明
key	お使いの API キー
action	status
order	注文ID

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=23501"

例の返信：

{
  "status": "In progress",
  "charge": "5.00",
  "start_count": 1000,
  "remains": 500,
  "currency": "USD",
  "autoDelivery": true
}

製品注文（例：アカウント）の場合、注文が完全または部分的に配信されると、レスポンスには配信されたアカウントの認証情報（アカウントごとに1つの文字列）を含む「accounts」配列が含まれます。部分配信の場合、これまでに配信されたアカウントのみが返されます。

autoDelivery：注文が自動的に処理される場合（例：SMM、自動/在庫製品）はtrue。サプライヤーが手動で対応する必要がある場合（時間がかかる場合があります）はfalse。

レスポンス例（アカウントが配信された製品注文）：

{
  "status": "Completed",
  "charge": "10.00",
  "start_count": 5,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": true,
  "accounts": [
    "user1:pass1",
    "user2:pass2"
  ]
}

可能なステータス:

PendingIn progressCompletedPartialCanceled

返金済みの注文は Canceled、一部返金の注文は Partial として返されます。返金が発生した場合、レスポンスには返金額（USD）を示す "refunded" も含まれます。

レスポンスの例（ファイルで納品された商品注文）:

一部の商品（セッションアーカイブ付きの Telegram アカウントなど）は、テキストの認証情報の代わりに、またはそれに加えて ZIP ファイルで納品されます。その場合、レスポンスには "files" 配列が含まれ、各ファイルが納品された 1 点に対応します。ファイルは action=order_file でダウンロードできます。

{
  "status": "Completed",
  "charge": "12.00",
  "start_count": 0,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": false,
  "files": [
    {
      "id": "66e6b2f0c3a1d2e4f5a6b7c8",
      "name": "sessions-001.zip",
      "size": 482113,
      "uploaded_at": "2026-09-15T08:30:00.000Z"
    }
  ]
}

注文ファイルをダウンロード

ご注文の納品ファイル（ZIP）を 1 つダウンロードします。成功するとレスポンスの本文がファイルそのもの（Content-Type: application/zip）になり、失敗すると "error" フィールドを含む JSON が返されます。

パラメータ	説明
key	お使いの API キー
action	order_file
order	注文ID
file	action=status の "files" 配列にあるファイル ID

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=order_file" \
  -d "order=23501" \
  -d "file=66e6b2f0c3a1d2e4f5a6b7c8" \
  -o sessions-001.zip

エラーレスポンスの例:

{
  "error": "File not found"
}

保存する前に Content-Type ヘッダーを確認してください。application/zip はファイル、application/json はエラーを意味します。

作成キャンセル

1つまたは複数の注文をキャンセルします（PerfectPanel対応の一括形式）。対象となる各注文は、残高に返金されます。

以下のすべてが真でなければなりません。返金処理を行わずに資格を確認するには、allowcancel を使用してください。

早期キャンセル：プラットフォーム機能が有効（管理者設定）。
早期キャンセル: productType が manual、auto、または inventory の場合（SMM の自動サービスは通常 productType が auto）
早期キャンセル：支払いステータスが「完了」または「一部完了」の場合。
早期キャンセル：注文ステータスが「保留中」「処理中」「エラー」（プロバイダーエラーは「進行中」と表示されます）の場合に可能です。
早期キャンセル: external_id なし（注文がまだ外部サプライヤーまたはプロバイダーに送信されていません）。
早期キャンセル：支払い完了から最低N分経過後（auto_order_early_refund_minutes、デフォルト30分）。
早期キャンセル：お客様はこの注文で早期自己返金をまだ利用していません。
早期キャンセル：注文が完全に配達されていない場合（一部配達の場合は、未配達分に応じて比例返金されます）。
早期キャンセル：返金可能額が残っています（返金額が注文合計より少ない場合）。
早期キャンセル：注文に進行中の異議申し立てがないこと。
早期キャンセル：依頼中または完了ステータスの仕入先引き出しはありません。

一部配送の場合は、それに応じて一部返金が行われ、配送済みのアカウントはそのまま保持されます。

パラメータ	説明
key	お使いの API キー
action	cancel
orders	注文ID（カンマ区切り、最大100件まで）

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "orders=23501,23502"

例の返信：

[
  {
    "order": 23501,
    "cancel": 1
  },
  {
    "order": 23502,
    "cancel": {
      "error": "Incorrect order ID"
    }
  }
]

キャンセルを許可する

1つ以上の注文が現在キャンセル可能かどうかを確認します（キャンセルと同じ条件ですが、返金は処理されません）。キャンセルを呼び出す前に使用することで、リクエストの失敗を防げます。バッチ注文ID（カンマ区切り、最大100件）に対応しています。

以下のすべてが真でなければなりません。返金処理を行わずに資格を確認するには、allowcancel を使用してください。

早期キャンセル：プラットフォーム機能が有効（管理者設定）。
早期キャンセル: productType が manual、auto、または inventory の場合（SMM の自動サービスは通常 productType が auto）
早期キャンセル：支払いステータスが「完了」または「一部完了」の場合。
早期キャンセル：注文ステータスが「保留中」「処理中」「エラー」（プロバイダーエラーは「進行中」と表示されます）の場合に可能です。
早期キャンセル: external_id なし（注文がまだ外部サプライヤーまたはプロバイダーに送信されていません）。
早期キャンセル：支払い完了から最低N分経過後（auto_order_early_refund_minutes、デフォルト30分）。
早期キャンセル：お客様はこの注文で早期自己返金をまだ利用していません。
早期キャンセル：注文が完全に配達されていない場合（一部配達の場合は、未配達分に応じて比例返金されます）。
早期キャンセル：返金可能額が残っています（返金額が注文合計より少ない場合）。
早期キャンセル：注文に進行中の異議申し立てがないこと。
早期キャンセル：依頼中または完了ステータスの仕入先引き出しはありません。

allowcancelが1の場合、レスポンスにはrefundAmount（キャンセル時に返金される金額）が含まれます。

パラメータ	説明
key	お使いの API キー
action	allowcancel
orders	注文ID（カンマ区切り、最大100件まで）

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=allowcancel" \
  -d "orders=23501,23502"

例の返信：

[
  {
    "order": 23501,
    "allowcancel": 1,
    "refundAmount": 5.00
  },
  {
    "order": 23502,
    "allowcancel": 0,
    "error": "Early auto refund is not available for this order",
    "reason": "BEFORE_MIN_WAIT",
    "eligibleAfter": "2026-06-23T12:30:00.000Z"
  }
]

残高

現在の残高を確認してください。

パラメータ	説明
key	お使いの API キー
action	balance

リクエスト例：

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

例の返信：

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

SMS 認証 API

SMS認証サービスのための専用エンドポイント。

SMS 注文には専用の注文 ID があります。これには sms_code、sms_status、sms_cancel を使用してください。status、cancel、allowcancel は商品注文と SMM 注文専用です。

1. SMSプロジェクトを入手

Action: sms_projects

パラメータ	説明
key	お使いの API キー
action	sms_projects
country	任意。国 ID で絞り込み（例 'us'、'gb'）
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。

[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

2. SMS対応国を取得

Action: sms_countries

パラメータ	説明
key	お使いの API キー
action	sms_countries
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。

[
  {
    "country_code": "+1",
    "country_name": "United States"
  },
  {
    "country_code": "+44",
    "country_name": "United Kingdom"
  }
]

3. SMS注文を作成

Action: add_sms

パラメータ	説明	必須
key	お使いの API キー
action	add_sms
project_id	sms_projects で取得したプロジェクト ID	はい
quantity	Number of numbers (1-10)	No (Default 1)
country	Country: ISO code (e.g. 'us') or dial code from sms_countries (e.g. '+1')	No
phone	再利用する電話番号	No

{
  "orders": [
    {
      "order": 12345,
      "phone": "4055123415",
      "dial_code": "+1",
      "phone_full": "+14055123415",
      "country": "US",
      "expires_at": "2026-01-01T12:15:00.000Z",
      "status": "active"
    }
  ]
}

4. SMSコードを取得

Action: sms_code

パラメータ	説明
key	お使いの API キー
action	sms_code
order	注文ID

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}
// OR, once expires_at has passed without a code (call sms_cancel for a refund)
{
  "status": "expired",
  "message": "No code arrived before the number expired. Call action=sms_cancel for a refund."
}

5. SMS注文ステータスを取得

Action: sms_status

パラメータ	説明
key	お使いの API キー
action	sms_status
order	注文ID

{
  "status": "code_received",
  "phone": "4055123415",
  "dial_code": "+1",
  "phone_full": "+14055123415",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "refunded": false,
  "expires_at": "2026-01-01T12:15:00.000Z"
}
// status: phone_acquired | code_received | expired | released

6. SMS 注文をキャンセル

Action: sms_cancel

番号を解放します。コードが届かなかった場合は、番号の有効期限が切れた後でも全額が残高に返金されます。すでにコードを受信した注文はキャンセルできません。

パラメータ	説明
key	お使いの API キー
action	sms_cancel
order	add_sms で取得した注文 ID

{
  "order": 12345,
  "status": "cancelled",
  "refunded": true,
  "refund_amount": "0.5000",
  "currency": "USD"
}
// OR
{
  "error": "Verification code already received, cannot release"
}

エラーレスポンス

よくあるエラー応答

{"error": "Invalid API key"}

{"error": "Invalid action"}

{"error": "Service ID is required"}

{"error": "Insufficient balance"}

{"error": "Order not found"}

{"error": "Service not found"}

お困りですか？お問い合わせはこちらまで support@hstockplus.com