Customer API - HstockPlus

Language

시작하기

HstockPlus/API 문서

API 키를 얻으려면 로그인하세요

귀하의 API 키

로드 중...

Test API

Select an action, fill in parameters, and send a request. When logged in, your API key is loaded automatically.

API 키

작업

API 엔드포인트

https://hstockplus.com/api/v2

모든 API 요청은 이 엔드포인트로 HTTP POST를 통해 전송되어야 합니다.

Get Categories

Get all categories and each category's subcategories. Use these values to filter the Services List by category or subcategory.

Parameter	Description	Required
key	Your API key	Yes
action	categories	Yes

예시 요청:

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

예시 응답:

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

서비스 목록

Get all available services with optional pagination. Each service includes stock (available quantity). Optional category and subcategory parameters return only services in that category or subcategory (values from the Get Categories API).

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

예시 요청:

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

페이지네이션 포함:

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

Filter by category or subcategory:

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"

예시 응답:

{
  "services": [
    {
      "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
    },
    {
      "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
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Each service includes stock (available quantity), entityType (smm or product), and autoDelivery (true if the service/product is auto-delivery, false if manual). When limit is 0 or omitted, all services are returned and page/limit equal total.

재고 확인

서비스 ID로 현재 재고 및 가용성 확인하기(서비스 목록의 ID와 동일).

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service ID (from services list)	Yes

예시 요청:

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

예시 응답:

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "entityType": "product",
  "autoDelivery": true
}

Response includes entityType (smm or product) and autoDelivery (true = auto-delivery, false = supplier fulfills manually).

주문 추가

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
}

제품 주문(예: 계정)의 경우, 주문이 완전히 또는 부분적으로 배송되면 응답에 배송된 계정 자격 증명(계정당 하나의 문자열)이 포함된 "accounts" 배열이 포함됩니다. 부분 배송의 경우, 지금까지 배송된 계정만 반환됩니다.

autoDelivery: true if the order is fulfilled automatically (e.g. SMM, auto/inventory products); false if the supplier must fulfill manually (may take some time).

응답 예시 (계정이 배송된 제품 주문):

{
  "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')

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

2. SMS 국가 가져오기

Action: sms_countries

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

3. SMS 주문 생성

Action: add_sms

Parameter	Description	Required
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
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

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

Test API

API 엔드포인트

Get Categories

예시 요청:

예시 응답:

서비스 목록

예시 요청:

예시 응답:

재고 확인

예시 요청:

예시 응답:

주문 추가

예시 요청:

예시 응답:

주문 상태

예시 요청:

예시 응답:

응답 예시 (계정이 배송된 제품 주문):

가능한 상태:

잔액

예시 요청:

예시 응답:

SMS Verification API

1. SMS 프로젝트 받기

2. SMS 국가 가져오기

3. SMS 주문 생성

4. SMS 코드 받기

5. SMS 주문 상태 확인

오류 응답

Supported payment methods