REST · JSON · v1

API 文档

用 HTTP 接口对接本站的商品、接码、社媒推广与代理 IP。所有接口与网站下单共用同一账户余额和订单。

接口地址

https://www.humkt.com/api/v1

认证请求头

Authorization: Bearer <token>

你的 API Token

登录后可见登录注册

登录后这里会显示你的 Token；还没有账号可以先注册，API 与网站共用同一账户余额。

在个人资料页生成 API Token(去生成)
每个请求带上 Authorization 请求头
先调「查询余额」确认连通，再按业务接入

账户 1 个接口 账号商品 7 个接口 接码（一次性验证码） 11 个接口 邮箱验证码 7 个接口 社媒推广 8 个接口 代理 IP 9 个接口

基本约定

接口地址：https://www.humkt.com/api/v1 只用 HTTPS。GET 参数放在查询串；POST 用 application/x-www-form-urlencoded(示例用 --data-urlencode 自动编码)或 JSON。建议始终带请求头 Accept: application/json。示例约定：先在终端执行 export TOKEN='你的 Token'（Token 见上方，默认隐藏）。示例里的 ID、链接、订单号都是虚构值，请换成你自己的；页面不会自动执行任何示例，下单类示例一旦运行就会真实扣款。布尔参数请传 1 或 0。金额单位为人民币(CNY)。余额与接码/社媒/代理的金额多为两位小数字符串；社媒 rate 为四位小数字符串；旧商品下单返回的 total_amount / snapshot_price、社媒批量的 created[].price 是数字。请按字段实际类型解析。时间：接码/社媒/代理多为 Y-m-d H:i:s（本站服务器时区，与网页一致）；旧商品接口的 created_at / updated_at 为带时区的 ISO 8601。

认证

每个请求都要认证，三种方式任选其一（同时传多个时按参数 → X-Api-Token → Bearer 的顺序取第一个非空值）: ① 请求头 Authorization: Bearer <token>（推荐，示例都用这种） ② 请求头 X-Api-Token: <token> ③ 参数 token=<token>（放在查询串里会留在访问日志和历史记录中，不推荐） Token 必须是字符串；缺失、错误或传成数组都返回 401 UNAUTHORIZED。账号被限制或风控冻结返回 403 ACCOUNT_RESTRICTED;API 总开关关闭返回 503 SERVICE_DISABLED。参数表里的 token 行表示「认证必需」，可用请求头代替，不是业务参数。

返回格式与错误

接码 / 社媒 / 代理：成功 {"code":1,"message":"OK","data":…}，列表接口另有 meta（分页信息）。失败时 code 为 0,error 为机器可读错误码，message 为中文说明，并返回对应 HTTP 状态码。请按 error 判断，不要解析 message。失败响应可能带 retryable=true:表示没有扣款，稍后用相同参数重试可能成功（服务繁忙、维护中、线路暂不可用等）；带 data 时是这次失败对应的订单(已自动退款，refunded=true)。账户与账号商品（旧接口，为兼容老客户保持不变）:认证、限流、停用错误同上(401 / 403 / 429 / 503，带 error)；但业务失败（缺货、余额不足、订单不存在、非自选商品等）仍返回 HTTP 200 + code=0，只有 message，没有 error。参数格式错误返回框架原生的 422 {"message":…,"errors":{…}}，商品不存在返回 404。

HTTP	error	含义
401	UNAUTHORIZED	Token 缺失、错误或不是字符串
403	ACCOUNT_RESTRICTED	账号被限制或风控冻结
422	VALIDATION_ERROR	参数错误
402	INSUFFICIENT_BALANCE	余额不足，未扣款
409	PRICE_CHANGED	价格已变化，未扣款。接码 / 邮箱 max_price 超限时带当前单价 price；代理 max_amount 超限时带当前总价 amount；社媒批量带当前合计 total；其它情况可能不带价格字段，请重新查价
404	NOT_FOUND	订单或资源不存在（或不属于你）
422	OUT_OF_STOCK	缺货，未扣款
429	RATE_LIMITED	超过频率限制，按 Retry-After 秒后重试
409	DUPLICATE_IN_PROGRESS	相同 order_ref 的请求还在处理中，稍后用同一 order_ref 重试
503	SERVICE_DISABLED	API 或该功能暂时关闭
422	ORDER_FAILED	下单失败。没有扣款；或扣款后被拒、已自动退款（这时带 data，里面 refunded=true）。带 retryable=true 时稍后可重试
422	NOT_AVAILABLE	该服务 / 国家 / 邮箱类型暂时不能购买，未扣款
409 / 422	CANCEL_FAILED / CANCEL_NOT_AVAILABLE	当前不能取消（已收到码、已开始交付、刚下单还不允许取消等），未退款。接码看 cancel_in，社媒看 can_cancel
422	REFILL_NOT_AVAILABLE	当前不能补量，看订单的 can_refill / refill_available_at / warranty
503	UPSTREAM_UNAVAILABLE	目录或库存暂时无法获取，稍后重试（未扣款）

频率限制与重试

按 Token 和接口分别计数（每分钟），各接口上限见下表，没列出的查询类接口每分钟 300 次；同一 IP 所有接口合计每分钟约 900 次。超限返回 429 RATE_LIMITED，带 Retry-After、X-RateLimit-Limit、X-RateLimit-Remaining 头，请按 Retry-After 退避。网络超时后不要盲目重发下单请求，各接口的防重能力不同：· 代理购买：idempotency_key 必填，保存在订单上。用同一个值重试只返回同一张单，不会重复扣款（包括返回 202 的待确认订单）。 · 接码取号、社媒单笔下单：可带 order_ref。24 小时内同一 order_ref 返回原订单；前一个请求还在处理时返回 409 DUPLICATE_IN_PROGRESS，稍后用同一值重试。这是尽力防重：服务进程崩溃、单个请求处理超过锁时限（接码 90 秒、社媒 60 秒）等极端情况下不能保证严格只下一次，重试前最好先查订单列表确认。 · 账号商品下单、社媒批量下单、代理续费：没有持久幂等，不能无限安全重试。超时后先确认是否已成功(商品到网站「我的订单」核对，社媒查 /smm/orders，续费看 /proxy/list 的到期时间)，再决定是否重下。代理续费的 10 秒冷却只是防连点，不是幂等；续费返回 202 时不要重试。

接口	每分钟
POST /orders	120
GET /products/{id}/items	30
POST /sms/orders · GET /sms/lines	60
GET /sms/orders/{id}	120
POST /sms/orders/{id}/cancel · POST /sms/orders/{id}/resend	60
GET /sms/orders/{id}/resend	30
POST /mail/orders · POST /mail/orders/{order}/again	60（另有每个账户每小时 30 单）
GET /mail/orders/{order}	120
POST /mail/orders/{order}/cancel	60
POST /smm/orders	120
POST /smm/orders/batch	20
POST /smm/orders/{order}/refill · /cancel	60
POST /proxy/orders · POST /proxy/renew	30
GET /proxy/price · GET /proxy/renew-price	20（两个接口合计）
GET /proxy/cities	10
其它查询接口	300

账户

1 个接口

查询余额

GET /api/v1/balance

返回账户余额（CNY，两位小数字符串）。接码、社媒、代理、商品下单都从这里扣。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」

curl -sS -G 'https://www.humkt.com/api/v1/balance' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/balance",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/balance");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/balance');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "message": "OK",
  "code": 1,
  "data": {
    "balance": "125.53"
  }
}

账号商品

7 个接口

本组是旧接口：业务失败返回 HTTP 200 + code=0(只有 message)，参数格式错误返回框架原生 422，详见「返回格式与错误」。 自选购买（指定账号） ① 看商品的 is_selectable:true 才能选号。selectable_mode=required 必须选号；optional 可以选号，也可以不传 account_ids 由系统随机发货。is_selectable=false 的商品（包括随机发货的 Telegram 号等）直接下单，传 account_ids 会被拒绝。 ② 调 GET /products/{id}/items 翻页挑号，记下想要的 account_id（30 分钟内有效，价格已锁定）。 ③ 调 POST /orders,account_ids 传逗号分隔的 account_id,qty 等于个数（单次最多 50）。总价 = 所选账号 price 之和，不看商品列表里的 price。 ④ 自营库存立即发货；对接类账号异步发货(status=processing)，用返回的 trx 轮询 GET /orders/{trx}。所选账号在发货时已被他人买走或失效的，只退该账号的实付价(refunded_qty 增加)，不会换别的账号补发。下单失败(code=0)一律未扣款；提示「已过期」「已被购买」时重新调 items 再挑即可。

分类列表

GET /api/v1/categories

count 只统计已上架且有库存的商品数，父分类为子分类之和。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
flat	0\|1	否	1 返回扁平列表（带 parent_id），默认 0 树形

curl -sS -G 'https://www.humkt.com/api/v1/categories' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/categories",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/categories");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/categories');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "message": "OK",
  "code": 1,
  "data": [
    {
      "id": 1,
      "name": "Facebook",
      "parent_id": null,
      "icon": null,
      "created_at": "2025-01-02T03:04:05.000000Z",
      "children": [
        {
          "id": 5,
          "name": "Facebook 老号",
          "parent_id": 1,
          "icon": null,
          "created_at": "2025-01-03T03:04:05.000000Z",
          "children": [],
          "count": 120
        }
      ],
      "count": 120
    }
  ]
}

商品列表

GET /api/v1/products

分页返回可购买商品。产品组(is_group=true)不能直接下单，需用其子商品 id。is_selectable / selectable_mode 用来判断是否需要先选号（见本组开头「自选购买」）。每个账号价格不同的自选商品 price 可能是 0.00，实际价格以 items 返回为准。max_qty=0 表示不限购。description 为纯文本，最多 500 字（完整描述见商品详情）。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
q	string	否	关键词（匹配名称和描述）
category_id	integer	否	按分类筛选
in_stock	0\|1	否	1 仅有库存（默认）,0 包含无库存
seller_type	string	否	self=平台自营，seller=卖家
sort	string	否	price_asc（默认）\| price_desc \| created_at_desc
include	string	否	逗号分隔，可选 children、categories；不传时这两个字段返回空数组
page	integer	否	页码，默认 1
per_page	integer	否	每页数量，默认 50，最大 100
all	0\|1	否	1 一次返回全部商品、不分页（也可以 per_page=all）。数据量大，请间隔几分钟以上再调；平时用分页

curl -sS -G 'https://www.humkt.com/api/v1/products' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'category_id=5' \
  --data-urlencode 'per_page=50'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/products",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"category_id": "5", "per_page": "50"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/products");
url.search = new URLSearchParams({ "category_id": "5", "per_page": "50" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/products' . '?' . http_build_query(['category_id' => '5', 'per_page' => '50']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "id": 231,
      "name": "Instagram 老号",
      "price": "10.50",
      "in_stock": 50,
      "min_qty": 1,
      "max_qty": 100,
      "is_group": false,
      "is_selectable": false,
      "selectable_mode": null,
      "maintenance": false,
      "image_url": null,
      "description": "2020 年注册,带邮箱",
      "seller_type": "self",
      "seller_id": null,
      "categories": [],
      "children": []
    },
    {
      "id": 28014,
      "name": "TikTok 自选号",
      "price": "0.00",
      "in_stock": 12,
      "is_selectable": true,
      "selectable_mode": "required",
      "min_qty": 1,
      "max_qty": 100,
      "is_group": false,
      "maintenance": false,
      "image_url": null,
      "description": "2020 年注册,带邮箱",
      "seller_type": "self",
      "seller_id": null,
      "categories": [],
      "children": []
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 123,
    "last_page": 3
  }
}

商品详情

GET /api/v1/products/{id}

返回完整描述。需要子商品或分类时传 include=children,categories（默认不带，children / categories 为空数组）。商品不存在或已下架返回 404。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
id	integer	是	商品 ID（路径参数）
include	string	否	children、categories，逗号分隔

curl -sS -G 'https://www.humkt.com/api/v1/products/231' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'include=children,categories'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/products/231",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"include": "children,categories"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/products/231");
url.search = new URLSearchParams({ "include": "children,categories" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/products/231' . '?' . http_build_query(['include' => 'children,categories']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "message": "OK",
  "code": 1,
  "data": {
    "categories": [
      {
        "id": 5,
        "name": "Facebook 老号",
        "parent_id": 1
      }
    ],
    "children": [],
    "id": 231,
    "name": "Instagram 老号",
    "price": "10.50",
    "in_stock": 50,
    "min_qty": 1,
    "max_qty": 100,
    "is_group": false,
    "is_selectable": false,
    "selectable_mode": null,
    "maintenance": false,
    "image_url": null,
    "description": "2020 年注册,带邮箱",
    "seller_type": "self",
    "seller_id": null
  }
}

自选账号列表

GET /api/v1/products/{id}/items

仅 is_selectable=true 的商品可用（其它商品 HTTP 200 + code=0）。每条带一个 account_id:它就是这个账号的报价凭证 —— 价格在本次查询时锁定，30 分钟内有效，只能本人（同一 Token 的账号）使用，下单成功后即作废。同一商品最多保留你最近取到的 500 个 account_id，翻页过多时更早的会失效。已售出、近期购买失败过的账号不会出现，所以一页可能少于 per_page，是否还有下一页以 meta.has_more 为准。每个平台的附加字段不同，见下方「返回字段」。账号目录暂时取不到时返回 HTTP 200 + code=0，稍后再试。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
id	integer	是	商品 ID（路径参数）
page	integer	否	页码 1–50，默认 1
per_page	integer	否	1–40，默认 40。部分商品固定每页 40 条，以 meta.per_page 为准

返回字段

字段	适用	说明
account_id	全部	下单时传入 account_ids 的凭证（不是平台账号 ID）
username	全部	公开用户名；没有时为 null，部分商品会打码（如 ab***yz）
profile_url	全部	公开主页链接，可能为 null
price / currency	全部	这个账号的锁定单价（两位小数字符串，CNY）。下单总价 = 所选账号 price 之和
country	多数平台（本站自营的自选商品没有这个字段）	ISO 两位国家代码（大写），未知为 null
followers / likes / videos	TikTok	粉丝数 / 获赞数 / 作品数
followers / posts	Instagram	粉丝数 / 帖子数
premium / premium_expires	Telegram	是否 Premium 会员 / 会员到期时间（ISO 8601，非会员为 null）
session_days / id_length	Telegram	会话已存在天数 / 用户 ID 位数（位数越少注册越早）
has_2fa / spam_block	Telegram	是否设置了两步验证密码 / 是否被限制主动私聊
service / plan	AI 账号(ChatGPT / Grok …)	服务(chatgpt / grok / claude …)/ 订阅计划名（如 ChatGPT Plus、SuperGrok；免费号为 Free）
subscription_ends / auto_renew	AI 账号	订阅到期时间（ISO 8601，无订阅为 null）/ 是否自动续费
registered_at / usage_percent / balance	AI 账号	账号注册时间(ISO 8601)/ 额度已用百分比（0–100，未知为 null）/ API 余额（美元，未知为 null）
has_email / email_domain / has_phone / cookie_only	AI 账号	是否附带邮箱登录 / 邮箱域名 / 是否绑定手机 / 是否仅 Cookie 登录（无密码）
not_sold_before	AI 账号	是否首次出售（未转卖过）
date, year, followers, follows, following, posts, likes, videos, blue, has_phone, has_twofa / has_2fa, has_email / has_mail, has_cookie	其它平台（X 等）	注册日期、粉丝、关注、帖子、蓝 V、是否绑定手机 / 两步验证 / 邮箱等。只返回该账号实际有的字段
meta.has_more / raw_total	全部	是否还有下一页 / 符合条件的账号大致总数（含已被过滤的，仅供参考）
meta.pool_ttl	全部	account_id 有效期（秒）

curl -sS -G 'https://www.humkt.com/api/v1/products/28014/items' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'page=1'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/products/28014/items",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"page": "1"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/products/28014/items");
url.search = new URLSearchParams({ "page": "1" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/products/28014/items' . '?' . http_build_query(['page' => '1']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "account_id": "acc_5f8a3c1e9b7d4a2f6e0c8b1d3a5f7e9c",
      "username": "user1445",
      "profile_url": "https://www.tiktok.com/@user1445",
      "price": "3.50",
      "currency": "CNY",
      "country": "US",
      "followers": 1234,
      "likes": 5600,
      "videos": 18
    },
    {
      "account_id": "acc_0c2e7b9d1f4a6c8e3b5d7f9a1c3e5b7d",
      "username": "kate.mov",
      "profile_url": "https://www.tiktok.com/@kate.mov",
      "price": "4.20",
      "currency": "CNY",
      "country": null,
      "followers": 3080,
      "likes": 41200,
      "videos": 52
    }
  ],
  "meta": {
    "product_id": 28014,
    "selectable_mode": "required",
    "current_page": 1,
    "per_page": 40,
    "has_more": true,
    "raw_total": 86,
    "pool_ttl": 1800
  }
}

批量查价

GET /api/v1/prices

一次查询最多 300 个商品的当前价格与库存；不存在或已下架的 ID 不出现在结果里。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
ids	string	是	逗号分隔的商品 ID，如 231,232

curl -sS -G 'https://www.humkt.com/api/v1/prices' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'ids=231,232'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/prices",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"ids": "231,232"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/prices");
url.search = new URLSearchParams({ "ids": "231,232" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/prices' . '?' . http_build_query(['ids' => '231,232']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "message": "OK",
  "code": 1,
  "data": [
    {
      "id": 231,
      "price": "10.50",
      "in_stock": 50,
      "min_qty": 1,
      "max_qty": 100,
      "updated_at": "2026-09-24T13:10:03+00:00"
    }
  ]
}

购买商品

POST /api/v1/orders

余额支付。自营商品库存不足 qty 时整单拒绝、不扣款；自营商品立即发货(status=shipped)，对接类商品异步发货(status=processing)，用返回的 trx 轮询订单。没有持久幂等：超时后不要直接重发，先到网站「我的订单」核对。下单返回的 status=processing（发货中）在查单接口里显示为 pending（待发货）。不需要传 currency。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
id	integer	是	商品 ID（产品组请用子商品 ID）
qty	integer	是	数量，需在 min_qty–max_qty 内
account_ids	string	否	自选商品用：逗号分隔的 account_id（来自 items 接口），个数必须等于 qty，最多 50。selectable_mode=required 必填，optional 可不传（随机发货）,is_selectable=false 的商品不能传。例：acc_5f8a…,acc_0c2e…

下单常见失败（HTTP 200 + code=0，均未扣款）

message	原因 / 处理
该产品需要先指定具体账号…	selectable_mode=required 但没传 account_ids
qty (x) 必须等于 account_ids 的数量 (y)	qty 与 account_id 个数不一致
一次最多选择 50 个账号	单次超过 50 个，请分多单
账号信息已过期… / 部分 account_ids 已过期或非法…	account_id 超过 30 分钟、不是你取到的、或已被更新的翻页挤掉。重新调 items
account_ids 中存在重复账号	同一个账号传了两次
部分所选账号已被购买…	有账号刚被别人买走。重新调 items 再挑
该商品随机发货，不支持指定账号…	is_selectable=false 的商品传了 account_ids，去掉即可
该商品暂时缺货，请稍后再试	货源暂时无法供货（补货或维护中），稍后重试
该产品处于维护，暂不可购买	商品维护中（商品 maintenance=true），先跳过
该商品所属卖家正在休假，暂停销售	卖家休假，暂停销售
该商品是产品组，不能直接下单…	对产品组下单。返回里带 data.is_group=true 和 data.variants（子商品 id、name、price、in_stock），改用子商品 id
最少需购买 N 个 / 最多只能购买 N 个	qty 不在 min_qty–max_qty 内（max_qty=0 表示不限）
库存为 0，无法购买 / 库存不足，仅剩 N 个	库存不够 qty，整单不下
余额不足,无法完成购买	余额不足
你不能使用钱包余额购买此类商品	这类商品不能用余额购买，请到网站用其它方式付款
请遵守支付限制。最小支付金额: X 元	订单金额低于最低支付金额，加大 qty

curl -sS -X POST 'https://www.humkt.com/api/v1/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'id=231' \
  --data-urlencode 'qty=1'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"id": "231", "qty": "1"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/orders", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "id": "231", "qty": "1" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/orders');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['id' => '231', 'qty' => '1']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "message": "下单成功",
  "code": 1,
  "data": {
    "trx": "AJS1Y6IURTYZ",
    "order_id": 123,
    "id": 123,
    "product_id": 231,
    "total_amount": 10.5,
    "qty": 1,
    "snapshot_name": "Instagram 老号",
    "snapshot_price": 10.5,
    "status": "processing",
    "status_label": "发货中",
    "delivered": 0,
    "created_at": "2026-09-24T13:10:03.000000Z"
  }
}

查询商品订单

GET /api/v1/orders/{trx}

status:pending 待发货 / partial 部分发货 / shipped 已发货 / refunded 已全额退款 / unpaid 未支付。 items 为发货内容，只返回已付款、未全额退款的订单；部分退款时已退回的账号不再出现在 items 里（refunded_qty、refunded_amount 会增加）。 refund_state:none 未退款 / partial 部分退款 / full 全额退款。delivery_type:auto 自动发货 / manual 卖家手动发货。after_sales_until:售后截止时间(ISO 8601)，商品不支持售后时为 null。 不存在时 HTTP 200 + code=0。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
trx	string	是	下单返回的 trx（或订单 ID），路径参数

curl -sS -G 'https://www.humkt.com/api/v1/orders/AJS1Y6IURTYZ' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/orders/AJS1Y6IURTYZ",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/orders/AJS1Y6IURTYZ");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/orders/AJS1Y6IURTYZ');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "message": "OK",
  "code": 1,
  "data": {
    "trx": "AJS1Y6IURTYZ",
    "order_id": 123,
    "status": "shipped",
    "status_label": "已发货",
    "qty": 1,
    "delivered": 1,
    "refunded_qty": 0,
    "items": [
      "login:password"
    ],
    "product_id": 231,
    "product_name": "Instagram 老号",
    "amount": "10.50",
    "refunded_amount": "0.00",
    "refund_state": "none",
    "delivery_type": "auto",
    "after_sales_until": "2026-09-25T13:10:03+08:00",
    "created_at": "2026-09-24T13:10:03+08:00"
  }
}

接码（一次性验证码）

11 个接口

流程：/sms/services 选服务 → /sms/countries 选国家 → （可选）/sms/lines 选线路 → POST /sms/orders 取号 → 每 3–5 秒轮询 /sms/active 等验证码。没收到验证码可取消，全额退回余额；超时未收到码系统自动取消退款。已收到码的订单不退款。

服务列表

GET /api/v1/sms/services

可接码的 App/网站。min_price 为各国家中的最低价。目录暂时取不到时返回 503 UPSTREAM_UNAVAILABLE（不是空列表）。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
q	string	否	搜索（支持中文，如微信）

curl -sS -G 'https://www.humkt.com/api/v1/sms/services' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'q=telegram'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/sms/services",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"q": "telegram"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/sms/services");
url.search = new URLSearchParams({ "q": "telegram" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/services' . '?' . http_build_query(['q' => 'telegram']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "id": 907,
      "name": "Telegram",
      "popular": true,
      "min_price": "2.16",
      "country_count": 158
    }
  ],
  "meta": {
    "count": 1,
    "currency": "CNY"
  }
}

国家与价格

GET /api/v1/sms/countries

某服务可选的国家，按有货优先、推荐度排序。price~price_max 为有货线路的价格区间，stock 为参考库存。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
service_id	integer	是	服务 ID

curl -sS -G 'https://www.humkt.com/api/v1/sms/countries' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'service_id=907'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/sms/countries",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"service_id": "907"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/sms/countries");
url.search = new URLSearchParams({ "service_id": "907" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/countries' . '?' . http_build_query(['service_id' => '907']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "id": 1,
      "name": "美国",
      "code": "us",
      "price": "10.80",
      "price_max": "11.56",
      "success_rate": 45,
      "stock": 7954,
      "voice": true,
      "recommended": true
    }
  ],
  "meta": {
    "count": 1,
    "currency": "CNY"
  }
}

线路

GET /api/v1/sms/lines

同一服务和国家下的不同号码线路，有货优先、按价格升序（线路 A 最便宜）。下单时不传 line 则自动用最便宜的有货线路。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
service_id	integer	是	服务 ID
country_id	integer	是	国家 ID

curl -sS -G 'https://www.humkt.com/api/v1/sms/lines' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'service_id=907' \
  --data-urlencode 'country_id=1'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/sms/lines",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"service_id": "907", "country_id": "1"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/sms/lines");
url.search = new URLSearchParams({ "service_id": "907", "country_id": "1" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/lines' . '?' . http_build_query(['service_id' => '907', 'country_id' => '1']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "line": 19,
      "label": "线路 A",
      "price": "10.80",
      "success_rate": 30,
      "stock": 1104,
      "available": true,
      "areacode": false
    }
  ],
  "meta": {
    "currency": "CNY"
  }
}

取号

POST /api/v1/sms/orders

扣款并返回号码。缺货、余额不足(402)、价格高于 max_price（409，带当前单价 price）时不扣款。quantity>1 时每个号码独立计费、独立可取消；部分缺货时只返回取到的号码，message 以「部分成功：」开头，meta.obtained 为实际取到的个数。 其它失败（均未扣款，HTTP 422）:NOT_AVAILABLE 该服务在此国家暂不可购买；VOICE_UNAVAILABLE 该国家不支持语音；ORDER_FAILED 取号失败（带 retryable=true 时为服务维护或繁忙，稍后重试）。 同一 order_ref 重复提交返回原订单：message 为「已受理相同请求」，顶层 duplicate=true。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
service_id	integer	是	服务 ID
country_id	integer	是	国家 ID
line	integer	否	线路（来自 /sms/lines），不传自动选最便宜有货线路
max_price	number	否	单价上限，当前价更高则返回 409 PRICE_CHANGED
activation_type	string	否	SMS（默认）/ VOICE（语音，仅部分国家）/ FLASH
areacode	string	否	指定区号（线路 areacode=true 时可用）
quantity	integer	否	一次取多个号，1–10，默认 1
order_ref	string	否	你方单号（≤64 字符，也可用请求头 X-Idempotency-Key）。24 小时内同一 order_ref 返回原订单；尽力防重，限制见「频率限制与重试」

curl -sS -X POST 'https://www.humkt.com/api/v1/sms/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'service_id=907' \
  --data-urlencode 'country_id=1' \
  --data-urlencode 'max_price=12' \
  --data-urlencode 'order_ref=C10086'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/sms/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"service_id": "907", "country_id": "1", "max_price": "12", "order_ref": "C10086"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/sms/orders", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "service_id": "907", "country_id": "1", "max_price": "12", "order_ref": "C10086" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/orders');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['service_id' => '907', 'country_id' => '1', 'max_price' => '12', 'order_ref' => 'C10086']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "下单成功",
  "data": [
    {
      "id": 58231,
      "tracking": "SMS2609245K3JQ1",
      "phone": "12025550123",
      "service_id": 907,
      "service_name": "Telegram",
      "country_id": 1,
      "country_name": "美国",
      "country_code": "us",
      "activation_type": "SMS",
      "price": "10.80",
      "status": "pending",
      "code": null,
      "full_sms": null,
      "sms_history": [],
      "time_left": 1199,
      "awaiting_resend": false,
      "refunded": false,
      "finished": false,
      "reason": null,
      "created_at": "2026-09-24 21:10:03",
      "dial_code": "1",
      "expires_at": "2026-09-24 21:30:03",
      "cancel_in": 0
    }
  ],
  "meta": {
    "requested": 1,
    "obtained": 1,
    "balance": "89.20"
  }
}

进行中的号码（轮询）

GET /api/v1/sms/active

一次返回你所有进行中的号码及其验证码，推荐 3–5 秒轮询一次，不要逐个订单轮询。received 为本次刚收到码的订单。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」

curl -sS -G 'https://www.humkt.com/api/v1/sms/active' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/sms/active",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/sms/active");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/active');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "active": [
      {
        "status": "completed",
        "code": "48213",
        "full_sms": "Telegram code: 48213",
        "time_left": 903,
        "id": 58231,
        "tracking": "SMS2609245K3JQ1",
        "phone": "12025550123",
        "service_id": 907,
        "service_name": "Telegram",
        "country_id": 1,
        "country_name": "美国",
        "country_code": "us",
        "activation_type": "SMS",
        "price": "10.80",
        "sms_history": [],
        "awaiting_resend": false,
        "refunded": false,
        "finished": false,
        "reason": null,
        "created_at": "2026-09-24 21:10:03",
        "dial_code": "1",
        "expires_at": "2026-09-24 21:30:03",
        "cancel_in": 0
      }
    ],
    "received": [
      {
        "status": "completed",
        "code": "48213",
        "full_sms": "Telegram code: 48213",
        "time_left": 903,
        "id": 58231,
        "tracking": "SMS2609245K3JQ1",
        "phone": "12025550123",
        "service_id": 907,
        "service_name": "Telegram",
        "country_id": 1,
        "country_name": "美国",
        "country_code": "us",
        "activation_type": "SMS",
        "price": "10.80",
        "sms_history": [],
        "awaiting_resend": false,
        "refunded": false,
        "finished": false,
        "reason": null,
        "created_at": "2026-09-24 21:10:03",
        "dial_code": "1",
        "expires_at": "2026-09-24 21:30:03",
        "cancel_in": 0
      }
    ]
  }
}

查询接码订单

GET /api/v1/sms/orders/{id}

status:pending 等码 / completed 已收码 / cancelled 已取消 / expired 超时 / refunded 已退款 / failed 失败。refunded=true 表示款项已退回余额。expires_at 为号码到期时间，time_left 为剩余秒数；cancel_in 为还要等几秒才能取消（0 表示现在可以取消）;dial_code 为国际区号。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
id	integer	是	订单 ID（路径参数）

curl -sS -G 'https://www.humkt.com/api/v1/sms/orders/58231' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/sms/orders/58231",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/sms/orders/58231");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/orders/58231');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "status": "completed",
    "code": "48213",
    "full_sms": "Telegram code: 48213",
    "time_left": 903,
    "id": 58231,
    "tracking": "SMS2609245K3JQ1",
    "phone": "12025550123",
    "service_id": 907,
    "service_name": "Telegram",
    "country_id": 1,
    "country_name": "美国",
    "country_code": "us",
    "activation_type": "SMS",
    "price": "10.80",
    "sms_history": [],
    "awaiting_resend": false,
    "refunded": false,
    "finished": false,
    "reason": null,
    "created_at": "2026-09-24 21:10:03",
    "dial_code": "1",
    "expires_at": "2026-09-24 21:30:03",
    "cancel_in": 0
  }
}

接码订单列表

GET /api/v1/sms/orders

按时间倒序，分页。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
status	string	否	active（进行中）/ pending / completed / cancelled / expired / refunded / failed
ids	string	否	逗号分隔的订单 ID，最多 100
page	integer	否	页码，默认 1
per_page	integer	否	每页数量，默认 50，最大 100

curl -sS -G 'https://www.humkt.com/api/v1/sms/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'status=active' \
  --data-urlencode 'per_page=50'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/sms/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"status": "active", "per_page": "50"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/sms/orders");
url.search = new URLSearchParams({ "status": "active", "per_page": "50" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/orders' . '?' . http_build_query(['status' => 'active', 'per_page' => '50']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "id": 58231,
      "tracking": "SMS2609245K3JQ1",
      "phone": "12025550123",
      "service_id": 907,
      "service_name": "Telegram",
      "country_id": 1,
      "country_name": "美国",
      "country_code": "us",
      "activation_type": "SMS",
      "price": "10.80",
      "status": "pending",
      "code": null,
      "full_sms": null,
      "sms_history": [],
      "time_left": 1199,
      "awaiting_resend": false,
      "refunded": false,
      "finished": false,
      "reason": null,
      "created_at": "2026-09-24 21:10:03",
      "dial_code": "1",
      "expires_at": "2026-09-24 21:30:03",
      "cancel_in": 0
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 12,
    "last_page": 1
  }
}

取消并退款

POST /api/v1/sms/orders/{id}/cancel

仅未收到码的订单可取消，全额退回余额。刚取号时要等 cancel_in 秒后才能取消；返回 422 CANCEL_FAILED 时稍等片刻再试。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
id	integer	是	订单 ID（路径参数）

curl -sS -X POST 'https://www.humkt.com/api/v1/sms/orders/58231/cancel' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/sms/orders/58231/cancel",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/sms/orders/58231/cancel", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/orders/58231/cancel');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query([]),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "已取消,款项已退回余额",
  "data": {
    "status": "cancelled",
    "refunded": true,
    "time_left": 0,
    "reason": "本人主动取消,已退款",
    "id": 58231,
    "tracking": "SMS2609245K3JQ1",
    "phone": "12025550123",
    "service_id": 907,
    "service_name": "Telegram",
    "country_id": 1,
    "country_name": "美国",
    "country_code": "us",
    "activation_type": "SMS",
    "price": "10.80",
    "code": null,
    "full_sms": null,
    "sms_history": [],
    "awaiting_resend": false,
    "finished": false,
    "created_at": "2026-09-24 21:10:03",
    "dial_code": "1",
    "expires_at": "2026-09-24 21:30:03",
    "cancel_in": 0
  }
}

完成订单

POST /api/v1/sms/orders/{id}/finish

已收到码且不再需要该号码时调用，订单从进行中移出。不调用则号码到期后自动结束。还没收到码的订单调用返回 422 INVALID_STATE。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
id	integer	是	订单 ID（路径参数）

curl -sS -X POST 'https://www.humkt.com/api/v1/sms/orders/58231/finish' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/sms/orders/58231/finish",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/sms/orders/58231/finish", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/orders/58231/finish');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query([]),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "已完成",
  "data": {
    "finished": true,
    "status": "completed",
    "code": "48213",
    "full_sms": "Telegram code: 48213",
    "time_left": 903,
    "id": 58231,
    "tracking": "SMS2609245K3JQ1",
    "phone": "12025550123",
    "service_id": 907,
    "service_name": "Telegram",
    "country_id": 1,
    "country_name": "美国",
    "country_code": "us",
    "activation_type": "SMS",
    "price": "10.80",
    "sms_history": [],
    "awaiting_resend": false,
    "refunded": false,
    "reason": null,
    "created_at": "2026-09-24 21:10:03",
    "dial_code": "1",
    "expires_at": "2026-09-24 21:30:03",
    "cancel_in": 0
  }
}

能否再收一条码

GET /api/v1/sms/orders/{id}/resend

已收码的号码是否还能再收一条，以及费用（free=true 为免费）。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
id	integer	是	订单 ID（路径参数）

curl -sS -G 'https://www.humkt.com/api/v1/sms/orders/58231/resend' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/sms/orders/58231/resend",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/sms/orders/58231/resend");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/orders/58231/resend');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "available": true,
    "free": false,
    "price": "2.30",
    "remaining": 2,
    "reason": null
  }
}

再收一条码

POST /api/v1/sms/orders/{id}/resend

按上面返回的费用另行扣款（余额不足返回 402 INSUFFICIENT_BALANCE，未扣款），之后继续轮询 /sms/active。重发失败返回 422 RESEND_FAILED（未扣款）。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
id	integer	是	订单 ID（路径参数）

curl -sS -X POST 'https://www.humkt.com/api/v1/sms/orders/58231/resend' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/sms/orders/58231/resend",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/sms/orders/58231/resend", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/sms/orders/58231/resend');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query([]),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "已请求重新发送,请等待新验证码",
  "data": {
    "awaiting_resend": true,
    "status": "completed",
    "code": "48213",
    "full_sms": "Telegram code: 48213",
    "time_left": 903,
    "id": 58231,
    "tracking": "SMS2609245K3JQ1",
    "phone": "12025550123",
    "service_id": 907,
    "service_name": "Telegram",
    "country_id": 1,
    "country_name": "美国",
    "country_code": "us",
    "activation_type": "SMS",
    "price": "10.80",
    "sms_history": [],
    "refunded": false,
    "finished": false,
    "reason": null,
    "created_at": "2026-09-24 21:10:03",
    "dial_code": "1",
    "expires_at": "2026-09-24 21:30:03",
    "cancel_in": 0
  }
}

邮箱验证码

7 个接口

流程：/mail/services 选平台和邮箱类型 → POST /mail/orders 拿到一个专属邮箱 → 用这个邮箱去对应平台注册或绑定 → 每 3–5 秒轮询 /mail/active，收到后返回验证码 code 和邮件正文 text。没收到验证码可以取消，全额退回余额；到期还没收到的系统自动取消退款。已收到码的订单不退款。同一个邮箱可以用 /again 再接另一个平台的验证码（每个邮箱每个平台只能接一次，重复接同一平台返回 422 USED）。每个账户每小时有下单上限（目前 30 单），需要更高请联系客服。

平台与邮箱类型

GET /api/v1/mail/services

可接码的平台（Facebook、Instagram、Google、TikTok、Telegram、X、Discord 等），以及每个平台可选的邮箱类型(domains)的售价和库存。stock=0 表示暂时没货。目录暂时取不到时返回 503 UPSTREAM_UNAVAILABLE。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
service_id	integer	否	只看某个平台

curl -sS -G 'https://www.humkt.com/api/v1/mail/services' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'service_id=1'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/mail/services",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"service_id": "1"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/mail/services");
url.search = new URLSearchParams({ "service_id": "1" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/mail/services' . '?' . http_build_query(['service_id' => '1']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "service_id": 1,
      "name": "Facebook",
      "slug": "facebook",
      "min_price": "0.04",
      "stock": 672289,
      "domains": [
        {
          "domain_id": 9,
          "domain": "outlook.com",
          "family": "outlook",
          "price": "0.04",
          "stock": 2085
        },
        {
          "domain_id": 3,
          "domain": "icloud.com",
          "family": "icloud",
          "price": "0.22",
          "stock": 35977
        }
      ]
    }
  ],
  "meta": {
    "count": 1,
    "currency": "CNY",
    "updated_at": "2026-10-16 10:19:40"
  }
}

获取邮箱

POST /api/v1/mail/orders

扣款并返回专属邮箱(email),status=waiting 表示正在等验证码；极少数情况下先返回 status=pending（邮箱分配中），继续轮询即可。 以下情况都不扣款：余额不足 402 INSUFFICIENT_BALANCE；没货 422 OUT_OF_STOCK；单价高于 max_price 409 PRICE_CHANGED（带当前单价 price）；暂时不可购买 422 NOT_AVAILABLE；下单太频繁 429 RATE_LIMITED；服务繁忙 503 BUSY（稍后再试）。 如果扣款后才失败，会自动退款，返回的 data 里 refunded=true。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
service_id	integer	是	平台 ID（来自 /mail/services）
domain_id	integer	是	邮箱类型 ID（该平台 domains 里的 domain_id）
max_price	number	否	单价上限，当前价更高则返回 409 PRICE_CHANGED，不扣款
order_ref	string	否	你方单号（≤64 字符，也可用请求头 X-Idempotency-Key）。24 小时内同一 order_ref 只返回原订单

curl -sS -X POST 'https://www.humkt.com/api/v1/mail/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'service_id=1' \
  --data-urlencode 'domain_id=9' \
  --data-urlencode 'max_price=0.10' \
  --data-urlencode 'order_ref=C20088'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/mail/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"service_id": "1", "domain_id": "9", "max_price": "0.10", "order_ref": "C20088"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/mail/orders", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "service_id": "1", "domain_id": "9", "max_price": "0.10", "order_ref": "C20088" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/mail/orders');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['service_id' => '1', 'domain_id' => '9', 'max_price' => '0.10', 'order_ref' => 'C20088']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "下单成功",
  "data": {
    "id": 1203,
    "tracking": "MAIL261016QNDTZR",
    "service": "Facebook",
    "service_slug": "facebook",
    "domain_id": 9,
    "domain": "outlook.com",
    "email": "[email protected]",
    "price": "0.04",
    "status": "waiting",
    "code": null,
    "subject": null,
    "text": null,
    "refunded": false,
    "parent_id": null,
    "time_left": 1185,
    "created_at": "2026-10-16 10:20:03",
    "expires_at": "2026-10-16 10:40:03",
    "received_at": null
  },
  "duplicate": false,
  "balance": "89.16"
}

进行中的邮箱（轮询）

GET /api/v1/mail/active

一次返回你所有进行中的订单，以及最近 30 分钟内收到码的订单。推荐每 3–5 秒轮询这一个接口，不要逐个订单查询。收到后 status=received,code 为验证码，text 为邮件正文。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」

curl -sS -G 'https://www.humkt.com/api/v1/mail/active' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/mail/active",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/mail/active");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/mail/active');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "status": "received",
      "code": "492817",
      "subject": "Facebook confirmation code",
      "text": "492817 is your Facebook confirmation code",
      "time_left": 0,
      "received_at": "2026-10-16 10:21:47",
      "id": 1203,
      "tracking": "MAIL261016QNDTZR",
      "service": "Facebook",
      "service_slug": "facebook",
      "domain_id": 9,
      "domain": "outlook.com",
      "email": "[email protected]",
      "price": "0.04",
      "refunded": false,
      "parent_id": null,
      "created_at": "2026-10-16 10:20:03",
      "expires_at": "2026-10-16 10:40:03"
    }
  ],
  "meta": {
    "count": 1
  }
}

查询邮箱订单

GET /api/v1/mail/orders/{order}

status:pending 分配中 / waiting 等验证码 / received 已收到 / canceled 已取消（已退款）/ failed 失败（已退款）。refunded=true 表示款项已退回余额；time_left 为等码剩余秒数。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
order	string	是	订单 ID 或 tracking 单号（路径参数）

curl -sS -G 'https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "status": "received",
    "code": "492817",
    "subject": "Facebook confirmation code",
    "text": "492817 is your Facebook confirmation code",
    "time_left": 0,
    "received_at": "2026-10-16 10:21:47",
    "id": 1203,
    "tracking": "MAIL261016QNDTZR",
    "service": "Facebook",
    "service_slug": "facebook",
    "domain_id": 9,
    "domain": "outlook.com",
    "email": "[email protected]",
    "price": "0.04",
    "refunded": false,
    "parent_id": null,
    "created_at": "2026-10-16 10:20:03",
    "expires_at": "2026-10-16 10:40:03"
  }
}

邮箱订单列表

GET /api/v1/mail/orders

按时间倒序，分页。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
status	string	否	active（进行中）/ pending / waiting / received / canceled / failed / refunded
q	string	否	按邮箱地址或 tracking 精确查找
page	integer	否	页码，默认 1
per_page	integer	否	每页数量，默认 50，最大 100

curl -sS -G 'https://www.humkt.com/api/v1/mail/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'status=received' \
  --data-urlencode 'per_page=50'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/mail/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"status": "received", "per_page": "50"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/mail/orders");
url.search = new URLSearchParams({ "status": "received", "per_page": "50" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/mail/orders' . '?' . http_build_query(['status' => 'received', 'per_page' => '50']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "status": "received",
      "code": "492817",
      "subject": "Facebook confirmation code",
      "text": "492817 is your Facebook confirmation code",
      "time_left": 0,
      "received_at": "2026-10-16 10:21:47",
      "id": 1203,
      "tracking": "MAIL261016QNDTZR",
      "service": "Facebook",
      "service_slug": "facebook",
      "domain_id": 9,
      "domain": "outlook.com",
      "email": "[email protected]",
      "price": "0.04",
      "refunded": false,
      "parent_id": null,
      "created_at": "2026-10-16 10:20:03",
      "expires_at": "2026-10-16 10:40:03"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 8,
    "last_page": 1
  }
}

取消并退款

POST /api/v1/mail/orders/{order}/cancel

只能取消还在等码(waiting)的订单，全额退回余额。已收到码、或取消瞬间码刚好到了，返回 409 CANCEL_FAILED,data 里是订单最新状态。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
order	string	是	订单 ID 或 tracking 单号（路径参数）

curl -sS -X POST 'https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR/cancel' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR/cancel",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR/cancel", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR/cancel');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query([]),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "已取消，¥0.04 已退回钱包",
  "data": {
    "status": "canceled",
    "refunded": true,
    "time_left": 0,
    "id": 1203,
    "tracking": "MAIL261016QNDTZR",
    "service": "Facebook",
    "service_slug": "facebook",
    "domain_id": 9,
    "domain": "outlook.com",
    "email": "[email protected]",
    "price": "0.04",
    "code": null,
    "subject": null,
    "text": null,
    "parent_id": null,
    "created_at": "2026-10-16 10:20:03",
    "expires_at": "2026-10-16 10:40:03",
    "received_at": null
  },
  "balance": "89.20"
}

同一邮箱再接一个平台

POST /api/v1/mail/orders/{order}/again

用之前那个订单的邮箱，再接另一个平台的验证码，按该平台对应的邮箱类型单价另行扣款，返回一张新订单（parent_id 为原订单 ID）。同一邮箱同一平台只能接一次(422 USED)；原邮箱失效时返回 422 INVALID。其余规则同「获取邮箱」。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
order	string	是	订单 ID 或 tracking 单号（路径参数）
service_id	integer	是	要接的另一个平台 ID
max_price	number	否	单价上限
order_ref	string	否	你方单号，同「获取邮箱」

curl -sS -X POST 'https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR/again' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'service_id=3'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR/again",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"service_id": "3"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR/again", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "service_id": "3" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/mail/orders/MAIL261016QNDTZR/again');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['service_id' => '3']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "下单成功",
  "data": {
    "id": 1204,
    "tracking": "MAIL261016W8JX2P",
    "service": "Instagram",
    "service_slug": "instagram",
    "parent_id": 1203,
    "domain_id": 9,
    "domain": "outlook.com",
    "email": "[email protected]",
    "price": "0.04",
    "status": "waiting",
    "code": null,
    "subject": null,
    "text": null,
    "refunded": false,
    "time_left": 1185,
    "created_at": "2026-10-16 10:20:03",
    "expires_at": "2026-10-16 10:40:03",
    "received_at": null
  },
  "duplicate": false,
  "balance": "89.12"
}

社媒推广

8 个接口

流程：/smm/services 取服务 → （可选）POST /smm/estimate 计价 → POST /smm/orders 下单（立即扣款） → 用返回的 order 号查状态。状态：pending 排队 / in_progress 进行中 / completed 完成 / partial 部分完成（未完成部分已自动退款） / canceled 已取消 / failed 失败（已退款） / refunded 已退款。按服务 type 传参（详见下单参数表）:Default 等传 link + quantity;Custom Comments / Comment Replies 传 link + comments（每行一条，数量=有效行数）;Subscriptions 传 username + max + posts（+ min、delay、expiry、old_posts），计费数量 = max × posts;Poll 额外传 answer_number;Web Traffic 可传 country、device、type_of_traffic。服务带 input 字段时：minutes 需传 minutes（1–1440 分钟，按 quantity × minutes 计费）,reactions 需传 reactions。服务 dripfeed=true 时可传 dripfeed=1 + runs + interval（分钟），计费数量 = quantity × runs。

服务列表

GET /api/v1/smm/services

rate 为每 1000 个的售价（CNY，四位小数字符串）；实际扣款 = rate × 计费数量 / 1000，且不低于 meta.min_order_amount，以 /smm/estimate 为准。部分服务另有 input、target、reactions_allowed、comment_rules、schedulable、unit 字段。目录暂时取不到时返回 503 UPSTREAM_UNAVAILABLE。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
lang	string	否	zh \| en \| vi \| ru
q	string	否	按名称/分类搜索
category	string	否	分类精确匹配

curl -sS -G 'https://www.humkt.com/api/v1/smm/services' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'lang=en' \
  --data-urlencode 'q=instagram followers'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/smm/services",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"lang": "en", "q": "instagram followers"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/smm/services");
url.search = new URLSearchParams({ "lang": "en", "q": "instagram followers" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/smm/services' . '?' . http_build_query(['lang' => 'en', 'q' => 'instagram followers']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "service": 3575707,
      "name": "Instagram Followers",
      "category": "Instagram",
      "type": "Default",
      "rate": "252.7000",
      "min": 100,
      "max": 100000,
      "refill": true,
      "cancel": true,
      "dripfeed": false,
      "average_time": "3 小时",
      "description": ""
    }
  ],
  "meta": {
    "count": 1,
    "currency": "CNY",
    "min_order_amount": "1.00"
  }
}

计价

POST /api/v1/smm/estimate

参数与下单相同，只校验并返回扣款金额，不扣款。参数不合法返回 422 VALIDATION_ERROR。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
service	integer	是	服务 ID
…		否	其它参数与下单相同（按服务 type 条件必填）

curl -sS -X POST 'https://www.humkt.com/api/v1/smm/estimate' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'service=3575707' \
  --data-urlencode 'link=https://www.instagram.com/example/' \
  --data-urlencode 'quantity=100'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/smm/estimate",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"service": "3575707", "link": "https://www.instagram.com/example/", "quantity": "100"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/smm/estimate", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "service": "3575707", "link": "https://www.instagram.com/example/", "quantity": "100" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/smm/estimate');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['service' => '3575707', 'link' => 'https://www.instagram.com/example/', 'quantity' => '100']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "service": 3575707,
    "charge_quantity": 100,
    "charge": "25.27",
    "min_order_amount": "1.00",
    "currency": "CNY"
  }
}

下单

POST /api/v1/smm/orders

立即扣款。同一链接已有同类服务进行中时拒绝（DUPLICATE_ACTIVE_ORDER，防止重复加量）。价格刚变动返回 409 PRICE_CHANGED（不带 price，请重新查询/计价后再下），余额不足 402。传 order_ref 后 24 小时内重复提交只返回原订单（尽力防重）。 其它失败(HTTP 422):SERVICE_UNAVAILABLE 服务不存在或已下架；ORDER_FAILED 下单失败——没有扣款（带 retryable=true 时为服务暂时异常，稍后重试），或扣款后被明确拒单、已自动退款（这时带 data,status=failed、refunded=true,/smm/orders 里也能看到这张单）。 下单后迟迟没有结果的订单最长约 6 小时内自动处理，失败的自动退款。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
service	integer	是	服务 ID
link	string	否	条件必填：除 Subscriptions 外都要传目标链接（不能含空格；以 http 开头时须是完整 URL）
quantity	integer	否	条件必填：Default / Poll / Mentions / Web Traffic 等需传，范围 min–max;Custom Comments、Subscriptions 不用传
comments	string	否	Custom Comments / Comment Replies 必填：每行一条，空行和重复行不计，有效行数需在 min–max，单条 ≤200 字
username	string	否	Subscriptions 必填（账号用户名）;Comment Likes / Mentions 可选
min / max / posts	integer	否	Subscriptions:max 不低于服务 min,posts ≥ 1；计费数量 = max × posts
delay / expiry / old_posts	mixed	否	Subscriptions 可选：delay（分钟）、expiry(d/m/Y)、old_posts（老帖数量）
answer_number	string	否	Poll 必填：投票选项序号
country / device / type_of_traffic	mixed	否	Web Traffic 可选：device 1–5,type_of_traffic 1–3；另可传 google_keyword / referring_url
usernames / hashtag / groups / media	string	否	Mentions 可传 usernames / hashtag;Invites from Groups 用 groups、Mentions Media Likers 用 media（不传时取 link）
dripfeed / runs / interval	integer	否	仅 dripfeed=true 的服务：dripfeed=1，分 runs 批，每批 quantity 个，间隔 interval 分钟；计费数量 = quantity × runs
minutes	integer	否	服务 input=minutes 时必填：1–1440 分钟；按 quantity × minutes 计费
reactions	string\|array	否	服务 input=reactions 时必填：LIKE / LOVE / CARE / HAHA / WOW / SAD / ANGRY 中可选的一个或多个（以 reactions_allowed 为准），数组或逗号分隔
start_at	string	否	仅 schedulable=true 的服务：预约开始时间（本站时区），需在 10 分钟后到 7 天内
order_ref	string	否	你方单号（≤64 字符，也可用请求头 X-Idempotency-Key）,24 小时内防重复；尽力防重，限制见「频率限制与重试」

curl -sS -X POST 'https://www.humkt.com/api/v1/smm/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'service=3575707' \
  --data-urlencode 'link=https://www.instagram.com/example/' \
  --data-urlencode 'quantity=100' \
  --data-urlencode 'order_ref=A10086'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/smm/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"service": "3575707", "link": "https://www.instagram.com/example/", "quantity": "100", "order_ref": "A10086"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/smm/orders", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "service": "3575707", "link": "https://www.instagram.com/example/", "quantity": "100", "order_ref": "A10086" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/smm/orders');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['service' => '3575707', 'link' => 'https://www.instagram.com/example/', 'quantity' => '100', 'order_ref' => 'A10086']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "下单成功",
  "data": {
    "order": "SMM260924211003AB12",
    "service": 3575707,
    "link": "https://www.instagram.com/example/",
    "quantity": 100,
    "charge": "25.27",
    "currency": "CNY",
    "status": "pending",
    "start_count": null,
    "remains": null,
    "delivered": null,
    "refunded": false,
    "refund_amount": "0.00",
    "can_refill": false,
    "can_cancel": true,
    "dripfeed": null,
    "refill_status": null,
    "created_at": "2026-09-24 21:10:03",
    "updated_at": "2026-09-24 21:10:03",
    "refill_available_at": null,
    "refill_count": 0,
    "progress": null,
    "warranty": {
      "state": "pending",
      "days": 30,
      "expires_at": null,
      "remaining_days": null
    }
  },
  "duplicate": false,
  "balance": "74.73"
}

批量下单

POST /api/v1/smm/orders/batch

最多 50 行，每行「服务ID | 链接 | 数量」，仅支持 Default 这类「链接 + 数量」服务。建议先 preview=1 只校验计价拿到 total，再把它作为 expected_total 提交。提交前的预校验失败（任一行有误 422、合计已变 409 PRICE_CHANGED 并带当前 total、余额不足 402）整批不下单；通过后逐行下单，个别行仍可能失败（列在 failed，未扣款），即部分成功，charge 为实际扣款合计。没有持久幂等，超时后先查 /smm/orders 再决定是否重交。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
lines	string\|array	是	多行文本，或 [{service,link,quantity}]
preview	0\|1	否	1=只校验计价，不下单（返回 rows / total / valid / invalid）
expected_total	number	否	确认过的合计，与服务端合计相差超过 0.01 则 409 拒绝

curl -sS -X POST 'https://www.humkt.com/api/v1/smm/orders/batch' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'lines=3575707 | https://www.instagram.com/example/ | 100
3575707 | https://www.instagram.com/example2/ | 200' \
  --data-urlencode 'expected_total=75.81'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/smm/orders/batch",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"lines": "3575707 | https://www.instagram.com/example/ | 100\n3575707 | https://www.instagram.com/example2/ | 200", "expected_total": "75.81"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/smm/orders/batch", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "lines": "3575707 | https://www.instagram.com/example/ | 100\n3575707 | https://www.instagram.com/example2/ | 200", "expected_total": "75.81" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/smm/orders/batch');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['lines' => '3575707 | https://www.instagram.com/example/ | 100
3575707 | https://www.instagram.com/example2/ | 200', 'expected_total' => '75.81']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "批量下单完成",
  "data": {
    "batch_id": "B260924211003QX7Z",
    "created": [
      {
        "line": 1,
        "tracking": "SMM260924211003AB12",
        "price": 25.27
      }
    ],
    "failed": [
      {
        "line": 2,
        "error": "该链接已有同类订单进行中(#SMM260923100512CD34)"
      }
    ],
    "charge": "25.27"
  },
  "balance": "74.73"
}

查询订单

GET /api/v1/smm/orders/{order}

remains 为未完成数量，delivered 为已完成数量，progress 为完成百分比。refund_amount 为已退回余额的金额；refunded 只在全额退款时为 true，部分退款请看 refund_amount。 can_refill / can_cancel 与实际申请时的判断一致；补量冷却中时 refill_available_at 为可以申请的时间，refill_count 为已申请次数。 warranty.state:none 不保修 / pending 完成后开始计算 / active 保修中 / expired 已过保 / lifetime 终身 / refunded 已退款；expires_at、remaining_days 为到期时间和剩余天数。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
order	string	是	订单号（SMM 开头），路径参数

curl -sS -G 'https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "quantity": 1000,
    "charge": "252.70",
    "status": "partial",
    "start_count": 5230,
    "remains": 120,
    "delivered": 880,
    "refund_amount": "30.32",
    "can_cancel": false,
    "updated_at": "2026-09-25 03:12:40",
    "order": "SMM260924211003AB12",
    "service": 3575707,
    "link": "https://www.instagram.com/example/",
    "currency": "CNY",
    "refunded": false,
    "can_refill": false,
    "dripfeed": null,
    "refill_status": null,
    "created_at": "2026-09-24 21:10:03",
    "refill_available_at": null,
    "refill_count": 0,
    "progress": null,
    "warranty": {
      "state": "pending",
      "days": 30,
      "expires_at": null,
      "remaining_days": null
    }
  }
}

批量查状态 / 订单列表

GET /api/v1/smm/orders

传 orders 只查这些订单（最多取前 100 个），不传则列出全部；两种方式都按 page / per_page 分页（per_page 最大 100），查 100 个时请传 per_page=100。状态每分钟自动同步。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
orders	string	否	逗号分隔的订单号
status	string	否	按状态筛选：pending / in_progress / completed / partial / canceled / failed / refunded
page	integer	否	页码，默认 1
per_page	integer	否	每页数量，默认 50，最大 100

curl -sS -G 'https://www.humkt.com/api/v1/smm/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'orders=SMM260924211003AB12,SMM260923100512CD34' \
  --data-urlencode 'per_page=100'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/smm/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"orders": "SMM260924211003AB12,SMM260923100512CD34", "per_page": "100"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/smm/orders");
url.search = new URLSearchParams({ "orders": "SMM260924211003AB12,SMM260923100512CD34", "per_page": "100" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/smm/orders' . '?' . http_build_query(['orders' => 'SMM260924211003AB12,SMM260923100512CD34', 'per_page' => '100']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "order": "SMM260924211003AB12",
      "service": 3575707,
      "link": "https://www.instagram.com/example/",
      "quantity": 100,
      "charge": "25.27",
      "currency": "CNY",
      "status": "pending",
      "start_count": null,
      "remains": null,
      "delivered": null,
      "refunded": false,
      "refund_amount": "0.00",
      "can_refill": false,
      "can_cancel": true,
      "dripfeed": null,
      "refill_status": null,
      "created_at": "2026-09-24 21:10:03",
      "updated_at": "2026-09-24 21:10:03",
      "refill_available_at": null,
      "refill_count": 0,
      "progress": null,
      "warranty": {
        "state": "pending",
        "days": 30,
        "expires_at": null,
        "remaining_days": null
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 100,
    "total": 1,
    "last_page": 1
  }
}

申请补量

POST /api/v1/smm/orders/{order}/refill

订单 can_refill=true 时可申请：服务支持补量、订单已完成（部分服务部分完成也可以）、过了补量冷却期（见 refill_available_at，通常 24 小时）、仍在保修期内，且没有正在处理的补量申请。不可申请时返回 422 REFILL_NOT_AVAILABLE。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
order	string	是	订单号，路径参数

curl -sS -X POST 'https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12/refill' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12/refill",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12/refill", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12/refill');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query([]),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "补量申请已提交",
  "data": {
    "status": "completed",
    "remains": 0,
    "delivered": 100,
    "can_refill": true,
    "can_cancel": false,
    "refill_status": "requested",
    "order": "SMM260924211003AB12",
    "service": 3575707,
    "link": "https://www.instagram.com/example/",
    "quantity": 100,
    "charge": "25.27",
    "currency": "CNY",
    "start_count": null,
    "refunded": false,
    "refund_amount": "0.00",
    "dripfeed": null,
    "created_at": "2026-09-24 21:10:03",
    "updated_at": "2026-09-24 21:10:03",
    "refill_available_at": null,
    "refill_count": 0,
    "progress": null,
    "warranty": {
      "state": "pending",
      "days": 30,
      "expires_at": null,
      "remaining_days": null
    }
  }
}

申请取消

POST /api/v1/smm/orders/{order}/cancel

订单 can_cancel=true 时可申请：服务支持取消、订单未完成；多数服务只有还没开始交付才能取消，少数服务开始交付后也能取消剩余部分。未交付部分退回余额（可能需要几分钟）。不可取消时返回 422 CANCEL_NOT_AVAILABLE。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
order	string	是	订单号，路径参数

curl -sS -X POST 'https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12/cancel' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12/cancel",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12/cancel", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/smm/orders/SMM260924211003AB12/cancel');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query([]),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "已取消,按未交付 100/100 退款约 ¥25.27",
  "data": {
    "status": "canceled",
    "refunded": true,
    "refund_amount": "25.27",
    "can_cancel": false,
    "order": "SMM260924211003AB12",
    "service": 3575707,
    "link": "https://www.instagram.com/example/",
    "quantity": 100,
    "charge": "25.27",
    "currency": "CNY",
    "start_count": null,
    "remains": null,
    "delivered": null,
    "can_refill": false,
    "dripfeed": null,
    "refill_status": null,
    "created_at": "2026-09-24 21:10:03",
    "updated_at": "2026-09-24 21:10:03",
    "refill_available_at": null,
    "refill_count": 0,
    "progress": null,
    "warranty": {
      "state": "pending",
      "days": 30,
      "expires_at": null,
      "remaining_days": null
    }
  }
}

代理 IP

9 个接口

流程：/proxy/options 看类型/周期/国家 → /proxy/price 报价 → POST /proxy/orders 购买 → /proxy/list 取 IP、端口、账号密码。 购买必须带 idempotency_key:网络超时后用同一个值重试，只会返回同一张订单，不会重复扣款。购买返回 HTTP 202 表示已扣款、结果待确认，请稍后查询订单（用同一个 idempotency_key 重试也只会拿到这张单）。购买失败会自动退款(status=fail)。续费没有 idempotency_key:返回 202 时不要重试，稍后看 /proxy/list 的到期时间。

可选项

GET /api/v1/proxy/options

类型：dedicated 独享 / shared 共享 / ipv6 / mtproxy(Telegram)。周期单位为天。国家为两位小写代码。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」

curl -sS -G 'https://www.humkt.com/api/v1/proxy/options' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/proxy/options",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/proxy/options");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/options');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "types": [
      {
        "type": "dedicated",
        "ip_versions": [
          4,
          6
        ],
        "desc": "独享 IPv4/IPv6(HTTP + SOCKS5)"
      },
      {
        "type": "mtproxy",
        "ip_versions": [
          4
        ],
        "desc": "Telegram MTProxy(不支持指定城市/IP)"
      }
    ],
    "periods": [
      5,
      10,
      20,
      30,
      60,
      90,
      120,
      150,
      180,
      210,
      240,
      270,
      300,
      330,
      360
    ],
    "countries": [
      "ru",
      "de",
      "us",
      "gb"
    ],
    "limits": {
      "quantity_min": 1,
      "quantity_max": 2000,
      "ip_list_max": 2000
    },
    "currency": "CNY"
  }
}

报价

GET /api/v1/proxy/price

返回本次购买的总价。ipv6 固定 v6,mtproxy 固定 v4。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
type	string	否	dedicated（默认）\| shared \| ipv6 \| mtproxy
ip_version	integer	否	4 或 6，默认 4；其它值返回 422
country	string	是	国家代码，如 us
period	integer	是	天数（见 /proxy/options）
quantity	integer	否	数量 1–2000，默认 1

curl -sS -G 'https://www.humkt.com/api/v1/proxy/price' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'country=us' \
  --data-urlencode 'period=30' \
  --data-urlencode 'quantity=2'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/proxy/price",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"country": "us", "period": "30", "quantity": "2"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/proxy/price");
url.search = new URLSearchParams({ "country": "us", "period": "30", "quantity": "2" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/price' . '?' . http_build_query(['country' => 'us', 'period' => '30', 'quantity' => '2']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "type": "dedicated",
    "ip_version": 4,
    "country": "us",
    "period": 30,
    "quantity": 2,
    "amount": "50.98",
    "currency": "CNY"
  }
}

城市与可选 IP

GET /api/v1/proxy/cities

不带 city:返回有货城市及数量；带 city:返回该城市可指定购买的 IP 列表（用于 ip_list 下单）。取不到库存时返回 503 UPSTREAM_UNAVAILABLE。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
country	string	是	国家代码
type	string	否	dedicated \| shared
ip_version	integer	否	4 \| 6
city	integer	否	城市 ID

curl -sS -G 'https://www.humkt.com/api/v1/proxy/cities' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'country=us' \
  --data-urlencode 'type=dedicated' \
  --data-urlencode 'ip_version=4'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/proxy/cities",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"country": "us", "type": "dedicated", "ip_version": "4"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/proxy/cities");
url.search = new URLSearchParams({ "country": "us", "type": "dedicated", "ip_version": "4" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/cities' . '?' . http_build_query(['country' => 'us', 'type' => 'dedicated', 'ip_version' => '4']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "cities": [
      {
        "id": 440,
        "name": "Austin",
        "available": 1000
      }
    ],
    "ips": [],
    "need_city": true
  }
}

购买

POST /api/v1/proxy/orders

成功返回 200 与代理列表；202 为已扣款待确认；失败时未扣款或已自动退款。mtproxy 不支持 ip_list / city_id / city，传了会返回 422（不会静默忽略）。 购买时会重新报价，金额可能与 /proxy/price 略有不同，可以用 max_amount 设上限。 失败（均未扣款；带 retryable=true 的稍后重试）:503 ORDER_FAILED 该线路暂时无法购买（/proxy/price 仍可报价）;429 RATE_LIMITED 同一账号的上一笔购买还在处理，等几秒再试；500 ORDER_FAILED 下单失败；422 ORDER_FAILED 暂时无法报价；402 INSUFFICIENT_BALANCE 余额不足。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
idempotency_key	string	是	你生成的唯一键（≤64 字符），也可用请求头 X-Idempotency-Key。失败后重新购买请换新值
country	string	是	国家代码
period	integer	是	天数
quantity	integer	是	数量 1–2000（传 ip_list 时可不传）
type	string	否	dedicated \| shared \| ipv6 \| mtproxy
ip_version	integer	否	4 \| 6
ip_list[]	array	否	指定 IP（来自 /proxy/cities?city= 的 ips，不可重复）。要买某个城市的代理就用这个；mtproxy 不支持
city_id	integer	否	城市 ID，仅配合 ip_list 使用（单独传会被拒绝；mtproxy 不支持）
max_amount	number	否	总价上限。购买时会重新报价，高于它返回 409 PRICE_CHANGED（带当前总价 amount），不扣款

curl -sS -X POST 'https://www.humkt.com/api/v1/proxy/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'idempotency_key=4f1c2a9e-7b1d-4c55-9a0e-5d1f2b3c4d5e' \
  --data-urlencode 'country=us' \
  --data-urlencode 'period=30' \
  --data-urlencode 'quantity=2'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/proxy/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"idempotency_key": "4f1c2a9e-7b1d-4c55-9a0e-5d1f2b3c4d5e", "country": "us", "period": "30", "quantity": "2"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/proxy/orders", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "idempotency_key": "4f1c2a9e-7b1d-4c55-9a0e-5d1f2b3c4d5e", "country": "us", "period": "30", "quantity": "2" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/orders');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['idempotency_key' => '4f1c2a9e-7b1d-4c55-9a0e-5d1f2b3c4d5e', 'country' => 'us', 'period' => '30', 'quantity' => '2']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "购买成功",
  "data": {
    "order_no": "PO20260924211003AB12",
    "order_id": 4410,
    "country": "us",
    "city": null,
    "period": 30,
    "quantity": 2,
    "amount": "50.98",
    "currency": "CNY",
    "status": "ok",
    "created_at": "2026-09-24 21:10:03",
    "refunded_amount": "0.00",
    "refunded_at": null,
    "proxies": [
      {
        "id": 9812,
        "order_id": 4410,
        "type": "dedicated",
        "ip_version": 4,
        "ip": "203.0.113.10",
        "port_http": 49155,
        "port_socks5": 59155,
        "username": "u8812",
        "password": "p9x2",
        "country": "us",
        "city": null,
        "expires_at": "2026-10-24 21:10:03",
        "status": "active",
        "label": null
      }
    ]
  },
  "duplicate": false,
  "balance": "49.02"
}

查询订单

GET /api/v1/proxy/orders/{order_no}

status:ok 已交付 / pending 处理中 / fail 失败已退款。后台给这张单退过款（整单或部分代理）时 status 仍是 ok，退款金额看 refunded_amount、refunded_at。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
order_no	string	是	订单号（PO 开头）或订单 ID，路径参数

curl -sS -G 'https://www.humkt.com/api/v1/proxy/orders/PO20260924211003AB12' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/proxy/orders/PO20260924211003AB12",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/proxy/orders/PO20260924211003AB12");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/orders/PO20260924211003AB12');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "order_no": "PO20260924211003AB12",
    "order_id": 4410,
    "country": "us",
    "city": null,
    "period": 30,
    "quantity": 2,
    "amount": "50.98",
    "currency": "CNY",
    "status": "ok",
    "created_at": "2026-09-24 21:10:03",
    "refunded_amount": "0.00",
    "refunded_at": null,
    "proxies": [
      {
        "id": 9812,
        "order_id": 4410,
        "type": "dedicated",
        "ip_version": 4,
        "ip": "203.0.113.10",
        "port_http": 49155,
        "port_socks5": 59155,
        "username": "u8812",
        "password": "p9x2",
        "country": "us",
        "city": null,
        "expires_at": "2026-10-24 21:10:03",
        "status": "active",
        "label": null
      }
    ]
  }
}

订单列表

GET /api/v1/proxy/orders

按时间倒序，分页。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
page	integer	否	页码，默认 1
per_page	integer	否	每页数量，默认 50，最大 100

curl -sS -G 'https://www.humkt.com/api/v1/proxy/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/proxy/orders",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/proxy/orders");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/orders');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "order_no": "PO20260924211003AB12",
      "order_id": 4410,
      "country": "us",
      "city": null,
      "period": 30,
      "quantity": 2,
      "amount": "50.98",
      "currency": "CNY",
      "status": "ok",
      "created_at": "2026-09-24 21:10:03",
      "refunded_amount": "0.00",
      "refunded_at": null
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 3,
    "last_page": 1
  }
}

我的代理

GET /api/v1/proxy/list

含 IP、HTTP/SOCKS5 端口和账号密码。type=mtproxy 返回 MTProxy（ip、port、secret、tg_url）;ip、order_id 筛选对两种都有效。返回的 status:active 使用中 / expired 已到期 / deleted 已被回收（可能还没到期，不能再用也不能续费）。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
status	string	否	active \| expired \| deleted
type	string	否	mtproxy
ip	string	否	IP 模糊搜索
order_id	integer	否	只看某订单（订单 ID）
page	integer	否	页码，默认 1
per_page	integer	否	默认 100，最大 500

curl -sS -G 'https://www.humkt.com/api/v1/proxy/list' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'status=active' \
  --data-urlencode 'order_id=4410'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/proxy/list",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"status": "active", "order_id": "4410"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/proxy/list");
url.search = new URLSearchParams({ "status": "active", "order_id": "4410" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/list' . '?' . http_build_query(['status' => 'active', 'order_id' => '4410']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": [
    {
      "id": 9812,
      "order_id": 4410,
      "type": "dedicated",
      "ip_version": 4,
      "ip": "203.0.113.10",
      "port_http": 49155,
      "port_socks5": 59155,
      "username": "u8812",
      "password": "p9x2",
      "country": "us",
      "city": null,
      "expires_at": "2026-10-24 21:10:03",
      "status": "active",
      "label": null
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 100,
    "total": 1,
    "last_page": 1
  }
}

续费报价

GET /api/v1/proxy/renew-price

续费价格与网页端一致。count 不含已被回收或无法续费的代理；真正续费时还会再核对一次，已被回收的会进 skipped 不计费。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
ids	string	是	逗号分隔的代理 ID,1–100 个正整数
period	integer	是	天数

curl -sS -G 'https://www.humkt.com/api/v1/proxy/renew-price' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'ids=9812,9813' \
  --data-urlencode 'period=30'

import os, requests

resp = requests.get(
    "https://www.humkt.com/api/v1/proxy/renew-price",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    params={"ids": "9812,9813", "period": "30"},
    timeout=30,
)
print(resp.json())

const url = new URL("https://www.humkt.com/api/v1/proxy/renew-price");
url.search = new URLSearchParams({ "ids": "9812,9813", "period": "30" });
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json" },
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/renew-price' . '?' . http_build_query(['ids' => '9812,9813', 'period' => '30']));
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "OK",
  "data": {
    "count": 2,
    "period": 30,
    "amount": "25.49",
    "currency": "CNY"
  }
}

续费

POST /api/v1/proxy/renew

一次 1–100 个（正整数 ID，逗号分隔或数组）。已被回收的代理会出现在 skipped 中且不计费。续费失败自动退款；202 表示结果待确认，不要重试。同一账号 10 秒内只能提交一次（只是防连点，不是幂等），重复提交返回 429。失败返回 RENEW_FAILED（HTTP 422 / 500 / 503，已自动退款或未扣款）。

参数

名称	类型	必填	说明
token	string	认证	认证必需：推荐用请求头 Authorization: Bearer 传递，见「认证」
ids	string\|array	是	代理 ID,1–100 个正整数
period	integer	是	天数

curl -sS -X POST 'https://www.humkt.com/api/v1/proxy/renew' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'ids=9812,9813' \
  --data-urlencode 'period=30'

import os, requests

resp = requests.post(
    "https://www.humkt.com/api/v1/proxy/renew",
    headers={"Authorization": "Bearer " + os.environ["TOKEN"], "Accept": "application/json"},
    data={"ids": "9812,9813", "period": "30"},
    timeout=30,
)
print(resp.json())

const res = await fetch("https://www.humkt.com/api/v1/proxy/renew", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ "ids": "9812,9813", "period": "30" }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://www.humkt.com/api/v1/proxy/renew');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TOKEN'), 'Accept: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(['ids' => '9812,9813', 'period' => '30']),
]);
$res = json_decode(curl_exec($ch), true);
print_r($res);

返回示例

{
  "code": 1,
  "message": "续费成功",
  "data": {
    "status": "success",
    "amount": "25.49",
    "renewed": [
      {
        "id": 9812,
        "expires_at": "2026-11-23 21:10:03"
      },
      {
        "id": 9813,
        "expires_at": "2026-11-23 21:10:03"
      }
    ],
    "skipped": []
  },
  "balance": "23.53"
}