Customer API - HstockPlus

시작하기

HstockPlus/API 문서

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

귀하의 API 키

로드 중...

테스트 API

작업을 선택하고, 매개변수를 입력한 후 요청을 보내세요. 로그인하면 API 키가 자동으로 로드됩니다.

API 키

언어(선택 사항)

액션

명령 요청

작업 또는 매개변수를 변경하면 자동으로 업데이트됩니다.

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을 사용하여 영어로 표시하세요.

서비스/제품의 category 및 subcategory 필터 매개변수는 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 서비스 제외). 서비스 목록의 제품 행과 동일한 필드(id(MongoDB 제품 ID), service(친숙한 서비스 번호), 설명 및 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), 서비스(친숙한 서비스 번호), 재고, entityType(smm 또는 product)이 포함됩니다. 선택적 entityType은 product 또는 smm 행만 반환합니다. 선택적 category 및 subcategory 매개변수는 해당 카테고리 또는 하위 카테고리의 서비스만 반환합니다(Get Categories API의 값 사용). 선택적 shopId는 해당 상점의 제품 및 서비스만 반환합니다(Shops List의 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가 포함됩니다. 제품 행에는 설명과 imageUrl도 포함됩니다. limit이 0이거나 생략되면 모든 서비스가 반환되며 page/limit은 total과 같습니다.

재고 확인

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

예시 응답 (제품):

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

응답에는 rate(단위당, 서비스 목록과 동일한 문자열 형식), entityType(smm 또는 product), autoDelivery(true = 자동 전송, false = 공급업체가 수동으로 처리)가 포함됩니다. 상품 서비스의 경우 min과 max는 서비스 목록의 기본 하위 상품 행과 일치합니다. 해당 하위 상품이 주문 추가를 처리할 수 없는 경우 플랫폼은 다른 하위 상품을 선택하고 해당 단가를 청구할 수 있습니다. subproducts 배열은 표시 재고가 있는 모든 활성 변형을 나열합니다. SMM 인벤토리 응답에는 하위 상품이 포함되지 않습니다.

주문 추가

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(예: SMM, 자동/재고 제품); 공급업체가 수동으로 처리해야 하는 경우 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):

예시 응답 (제품):

주문 추가

예시 요청:

예시 응답:

주문 상태

예시 요청:

예시 응답:

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

가능한 상태:

잔액

예시 요청:

예시 응답:

SMS Verification API

1. SMS 프로젝트 받기

2. SMS 국가 가져오기

3. SMS 주문 생성

4. SMS 코드 받기

5. SMS 주문 상태 확인

오류 응답

지원되는 결제 방법