Customer API - HstockPlus

시작하기

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
    },
    {
      "service": 2,
      "name": "Instagram Comments",
      "type": "Custom Comments",
      "category": "Instagram",
      "rate": "5.00",
      "min": 10,
      "max": 1000,
      "refill": false,
      "cancel": false,
      "stock": 1000
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

각 서비스에는 재고(사용 가능 수량)가 포함됩니다. 한도가 0이거나 생략된 경우 모든 서비스가 반환되며 페이지/한도는 총 수량과 동일합니다.

재고 확인

서비스 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
}

주문 추가

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"
}

가능한 상태:

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.com