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를 통해 전송되어야 합니다.

중요 — 제품 이미지 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는 영어를 반환합니다.

지원되는 언어 코드

zhesfrdejakoptpt-BRruarhiviurbn-BDen(기본값 — lang을 생략하거나 en을 사용하세요)

lang 매개변수에 대해 이 정확한 값을 사용하세요. 별칭: jp는 ja로 허용됩니다.

읽기 작업에서 지원됨: categories, subcategory_info, 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"]
    }
  ]
}

하위 카테고리 정보

subcategoryId로 하위 카테고리 세부 정보를 가져오며, 상위 카테고리를 포함합니다. Products List 행의 subcategoryId를 사용하세요.

Parameter	Description	Required
key	Your API key	Yes
action	subcategory_info	Yes
subcategoryId	Subcategory ID from Products List	Yes
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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

상점 목록

기본 정보, 상품 수, 리뷰 평점과 함께 활성 상점을 나열합니다. 상점 이름은 개인정보 보호를 위해 마스킹 처리됩니다.

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(상품 엔터티 ID), service(친숙한 서비스 번호), description 및 imageUrl을 포함합니다. 선택적 productIds는 해당 상품만 반환합니다(목록의 친숙한 서비스 번호 및/또는 상품 엔터티 ID, 쉼표로 구분하거나 JSON 배열, 최대 100개). 선택적 sort=sold는 유료 주문 단위 기준 내림차순으로 결과를 정렬합니다(베스트셀러 우선).

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

하위 카테고리의 베스트셀러:

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

서비스 목록

모든 사용 가능한 서비스를 선택적 페이지네이션과 함께 조회합니다. 각 행에는 id(엔티티 ID), service(친숙한 서비스 번호), stock, entityType(smm 또는 product)이 포함됩니다. 선택적 entityType은 product 행 또는 smm 행만 반환합니다. 선택적 category 및 subcategory 파라미터는 해당 카테고리 또는 하위 카테고리의 서비스만 반환합니다(값은 Get Categories API에서 가져옴). 선택적 shopId는 해당 상점의 제품 및 서비스만 반환합니다(Shops List의 shopId 사용). 선택적 productIds는 일치하는 행만 반환합니다(친숙한 서비스 번호 및/또는 엔티티 ID; product 또는 smm 행과 일치). action=products를 사용하여 제품만 필터링합니다.

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 IDs (friendly service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns matching product or smm rows. Use action=products for products only.	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://cdn.hstockplus.org/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

각 행에는 id(엔티티 ID), service(주문용 친숙한 서비스 번호), stock, entityType(smm 또는 product) 및 autoDelivery가 포함됩니다. Product 행에는 description, imageUrl, isRecommended 및 subcategoryId도 포함됩니다. 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
}

예시 응답 (제품):

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

취소

하나 이상의 주문 취소 (PerfectPanel 호환 배치 형식). 각 적격 주문은 잔액으로 환불됩니다.

다음 모든 조건이 충족되어야 합니다. 환불 처리 없이 자격 확인을 위해 allowcancel을 사용하세요.

조기 취소: 플랫폼 기능 활성화 (관리자 설정).
조기 취소: productType이 auto 또는 inventory임 (SMM 자동 서비스는 일반적으로 productType auto 사용).
조기 취소: 결제 상태가 완료 또는 부분 완료임.
조기 취소: 주문 상태가 대기 중, 처리 중 또는 오류임 (공급자 오류는 진행 중으로 표시됨).
조기 취소: external_id 없음 (주문이 외부 공급업체나 제공업체로 아직 전송되지 않음).
조기 취소: 결제 완료 후 최소 N분 경과 (auto_order_early_refund_minutes, 기본값 30).
조기 취소: 고객이 이 주문에 대해 이미 조기 자체 환불을 사용하지 않음.
조기 취소: 주문이 완전히 전달되지 않음 (부분 전달 시 미전달 부분에 대해 비례 환불 제공).
조기 취소: 환불 가능 금액이 남아 있음 (refundedAmount가 주문 총액보다 적음).
조기 취소: 주문에 활성 분쟁 없음.
조기 취소: 요청 또는 완료 상태의 공급자 출금 없음.

부분 전달 시 비례 부분 환불 제공; 전달된 계정은 유지됨.

Parameter	Description
key	Your API key
action	cancel
orders	주문 ID (쉼표로 구분, 최대 100개 ID)

예시 요청:

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

취소 허용

하나 이상의 주문을 지금 취소할 수 있는지 확인합니다 (취소와 동일한 자격 규칙 적용, 환불은 처리되지 않음). 취소를 호출하기 전에 사용하여 실패한 요청을 방지하세요. 여러 주문 ID를 지원합니다 (쉼표로 구분, 최대 100개).

다음 모든 조건이 충족되어야 합니다. 환불 처리 없이 자격 확인을 위해 allowcancel을 사용하세요.

조기 취소: 플랫폼 기능 활성화 (관리자 설정).
조기 취소: productType이 auto 또는 inventory임 (SMM 자동 서비스는 일반적으로 productType auto 사용).
조기 취소: 결제 상태가 완료 또는 부분 완료임.
조기 취소: 주문 상태가 대기 중, 처리 중 또는 오류임 (공급자 오류는 진행 중으로 표시됨).
조기 취소: external_id 없음 (주문이 외부 공급업체나 제공업체로 아직 전송되지 않음).
조기 취소: 결제 완료 후 최소 N분 경과 (auto_order_early_refund_minutes, 기본값 30).
조기 취소: 고객이 이 주문에 대해 이미 조기 자체 환불을 사용하지 않음.
조기 취소: 주문이 완전히 전달되지 않음 (부분 전달 시 미전달 부분에 대해 비례 환불 제공).
조기 취소: 환불 가능 금액이 남아 있음 (refundedAmount가 주문 총액보다 적음).
조기 취소: 주문에 활성 분쟁 없음.
조기 취소: 요청 또는 완료 상태의 공급자 출금 없음.

allowcancel이 1일 때, 응답에 refundAmount 포함 (취소 시 환불될 금액).

Parameter	Description
key	Your API key
action	allowcancel
orders	주문 ID (쉼표로 구분, 최대 100개 ID)

예시 요청:

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

잔액

현재 잔액을 확인하세요.

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

귀하의 API 키

테스트 API

API 엔드포인트

선택적 언어(lang)

카테고리 가져오기

예시 요청:

예시 응답:

하위 카테고리 정보

예시 요청:

예시 응답:

상점 목록

예시 요청:

제품 목록

예시 요청:

서비스 목록

예시 요청:

예시 응답:

재고 확인

예시 요청:

예시 응답 (SMM):

예시 응답 (제품):

주문 추가

예시 요청:

예시 응답:

주문 상태

예시 요청:

예시 응답:

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

가능한 상태:

취소

예시 요청:

예시 응답:

취소 허용

예시 요청:

예시 응답:

잔액

예시 요청:

예시 응답:

SMS Verification API

1. SMS 프로젝트 받기

2. SMS 국가 가져오기

3. SMS 주문 생성

4. SMS 코드 받기

5. SMS 주문 상태 확인

오류 응답

지원되는 결제 방법