Customer API - HstockPlus

始めましょう

HstockPlus/API ドキュメント

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

あなたのAPIキー

読み込み中...

テストAPI

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

APIキー

言語（オプション）

アクション

I'd be happy to help you with a request command! However, I need a bit more context to provide the best response. Could you please clarify what kind of command you're looking for? For example: - A **Linux/terminal command** (e.g., `ls`, `grep`, `chmod`) - A **Windows command prompt** or **PowerShell** command - A **programming command** (e.g., Python, JavaScript, SQL) - A **game command** (e.g., Minecraft, Discord bots) - A **custom command** for a specific application or system Let me know the details, and I'll give you the exact command you need!

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

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

APIエンドポイント

https://hstockplus.com/api/v2

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

オプションの言語（lang）

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

サポート対象言語コード

zhesfrdejakoptpt-BRruarhiviurbn-BDen(デフォルト — langを省略するか、enを使用)

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

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

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

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

カテゴリを取得

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

Parameter	Description	Required
key	Your API key	Yes
action	categories	Yes
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

curl -X POST https://hstockplus.com/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"]
    }
  ]
}

ショップ一覧

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

Parameter	Description	Required
key	Your API key	Yes
action	shops	Yes
page	Page number (default 1).	No
limit	Items per page (default 20).	No

リクエスト例：

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

ページネーションあり：

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

製品一覧

マーケットプレイス製品のみを一覧表示します（SMMサービスは含みません）。サービス一覧のproduct行と同じフィールドで、id（MongoDB製品ID）、service（フレンドリーなサービス番号）、description、imageUrlを含みます。オプションのproductIdsでは、それらの製品のみを返します（一覧からのフレンドリーなサービス番号やMongoDB製品IDをカンマ区切りまたはJSON配列で指定、最大100件）。

Parameter	Description	Required
key	Your API key	Yes
action	products	Yes
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	Filter by category name (from Get Categories). Returns only products in this category.	No
subcategory	Filter by subcategory name (from Get Categories). Returns only products in this subcategory.	No
shopId	Filter by shop ID (from Shops List). Returns only that shop's products.	No
productIds	Optional list of product IDs (service numbers and/or MongoDB ids). Comma-separated, JSON array, or repeated fields. Returns only those products (max 100).	No
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

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

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

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

ページネーションあり：

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

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

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

サービス一覧

オプションのページネーション付きで、利用可能なすべてのサービスを取得します。各行には、id（MongoDBエンティティID）、service（フレンドリーなサービス番号）、stock、entityType（smmまたはproduct）が含まれます。オプションのentityTypeでは、product行またはsmm行のみを返します。オプションのcategoryおよびsubcategoryパラメータでは、そのカテゴリまたはサブカテゴリのサービスのみを返します（値はカテゴリ取得APIから取得）。オプションのshopIdでは、そのショップの製品とサービスのみを返します（shopIdはショップ一覧から使用）。オプションのproductIdsでは、一致するマーケットプレイス製品のみを返します（productIdsが設定されている場合、SMMサービスは除外されます）。

Parameter	Description	Required
key	Your API key	Yes
action	services	Yes
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	Filter by category name (from Get Categories). Returns only services in this category.	No
subcategory	Filter by subcategory name (from Get Categories). Returns only services in this subcategory.	No
shopId	Filter by shop ID (from Shops List). Returns only that shop's products and SMM services.	No
entityType	オプションのフィルター：productまたはsmm。マーケットプレイス製品のみ、またはSMMサービスのみを返します。	No
productIds	Optional list of product IDs (service numbers and/or MongoDB ids). Comma-separated, JSON array, or repeated fields. Returns only those products; SMM rows are omitted.	No
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

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

ページネーションあり：

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

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

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

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

curl -X POST https://hstockplus.com/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://example.com/uploads/products/gmail.webp"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

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

在庫を確認

サービスID（サービス一覧と同じID）でサービスの現在の在庫と利用可能性を取得します。マーケットプレイス製品の場合、JSONにはサブ製品が含まれます。アクティブなバリアントの配列で、各バリアントにはsubproductId、name、stock（そのバリアントの表示在庫）が含まれます。

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service ID (from services list)	Yes
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。	No

リクエスト例：

curl -X POST https://hstockplus.com/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 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0 }
  ]
}

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

注文を追加

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.

Parameter	Description	Required
key	Your API key	Yes
action	add	Yes
service	Service ID	Yes
link	Link: For SMM orders (e.g. followers, likes, comments): required — URL or link to the content (e.g. Instagram post URL). For product orders (e.g. accounts): optional — delivery email or reference; if empty, the system uses your account email.	No
quantity	Quantity to order	Yes

リクエスト例：

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

例の返信：

{
  "order": 23501
}

注文状況

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

Parameter	Description
key	Your API key
action	status
order	Order ID

リクエスト例：

curl -X POST https://hstockplus.com/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

残高

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

Parameter	Description
key	Your API key
action	balance

リクエスト例：

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

例の返信：

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

SMS Verification API

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

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

Action: sms_projects

Parameter	Description
key	Your API key
action	sms_projects
country	Optional. Filter by country ID (e.g. '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

Parameter	Description
key	Your API key
action	sms_countries
lang	オプションの言語コード。上記の「オプション言語（lang）」のサポート対象コードを参照してください。

[
  {
    "country_code": "us",
    "country_name": "United States"
  },
  {
    "country_code": "gb",
    "country_name": "United Kingdom"
  }
]

3. SMS注文を作成

Action: add_sms

Parameter	Description	Required
key	Your API key
action	add_sms
project_id	Project ID from sms_projects	Yes
quantity	Number of numbers (1-10)	No (Default 1)
country	Country code (e.g. 'us')	No
phone	Phone number to reuse	No

{
  "orders": [
    {
      "order": 12345,
      "phone": "+1234567890",
      "country": "us",
      "status": "active"
    }
  ]
}

4. SMSコードを取得

Action: sms_code

Parameter	Description
key	Your API key
action	sms_code
order	Order ID

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}

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

Action: sms_status

Parameter	Description
key	Your API key
action	sms_status
order	Order ID

{
  "status": "code_received",
  "phone": "+1234567890",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "expires_at": "2023-01-01T12:00:00.000Z"
}

エラーレスポンス

よくあるエラー応答

{"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.net

あなたのAPIキー

テストAPI

APIエンドポイント

オプションの言語（lang）

カテゴリを取得

リクエスト例：

例の返信：

ショップ一覧

リクエスト例：

製品一覧

リクエスト例：

サービス一覧

リクエスト例：

例の返信：

在庫を確認

リクエスト例：

レスポンス例（SMM）：

レスポンス例（product）：

注文を追加

リクエスト例：

例の返信：

注文状況

リクエスト例：

例の返信：

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

可能なステータス:

残高

リクエスト例：

例の返信：

SMS Verification API

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

2. SMS対応国を取得

3. SMS注文を作成

4. SMSコードを取得

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

エラーレスポンス

対応決済方法