你的平台用户每完成一笔订单，调用一次接口，群星自动完成身份绑定、能力标签、执行记录与等级计算。
用 appKey + 你平台的用户 ID 自动建立唯一映射，有手机号还可匹配已有群星账号，无需用户重新注册。
每一单沉淀为不可篡改的执行记录，按能力标签归类。标签首次出现自动创建、免审核。
群星根据累计完成数与平均评分自动计算 S1–S6 等级，能力跨平台携带、互认。
在接入控制台用邮箱登录，即时下发 appKey 与 appSecret。
用户每完成一单，按签名规则调用 POST /sync 一个接口即可。
群星自动创建身份、分配能力标签、记录执行并计算等级。
https://api.qunxing.app/open-api/v1
所有请求需携带以下 Header：
Authorization: Bearer {appKey}:{timestamp}:{signature} Content-Type: application/json
签名生成方式（沙盒可实时演算）：
# timestamp = 当前 Unix 毫秒时间戳 signature = HMAC_SHA256(appSecret, appKey + "\n" + timestamp + "\n" + requestBody)
时间戳误差超过 5 分钟的请求将被拒绝。
{
"platformUserId": "your_user_id_12345",
"nickname": "用户昵称",
"mobile": "+8613800138000",
"tagName": "你的平台对应的能力标签名",
"order": {
"externalOrderId": "YOUR_ORDER_NO_001",
"title": "完成的订单描述",
"amount": 299.00,
"currency": "CNY",
"buyerRating": 5
}
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
platformUserId | string | 必填 | 你平台上的用户唯一标识 |
nickname | string | 可选 | 用户显示名 |
mobile | string | 可选 | 手机号，有则用于匹配已有群星账号 |
avatarUrl | string | 可选 | 头像 URL |
tagName | string | 可选 | 能力标签名（接入方自定义，如"美团"、"淘宝电商"）。首次出现自动创建，归入"行践"类目下；也可用"一级/标签"格式指定归属（如"造物/3D打印"）。 |
order.externalOrderId | string | 必填 | 你平台的订单号（幂等键，重复不计数） |
order.title | string | 必填 | 订单描述 |
order.amount | number | 可选 | 成交金额 |
order.currency | string | 可选 | 币种，默认 CNY |
order.buyerRating | int | 可选 | 买家评分 1-5，默认 5 |
{
"code": 0,
"data": {
"aidanfupiId": "QX7281940023",
"isNewUser": false,
"rank": "S2",
"executionCount": 152,
"abilities": ["外卖配送"],
"orderRecorded": true,
"duplicate": false
}
}{
"code": 0,
"data": {
"bound": true,
"aidanfupiId": "QX7281940023",
"rank": "S2",
"executionCount": 152,
"abilities": ["外卖配送", "骑手调度"],
"totalAmount": 45820.00
}
}{
"users": [
{ "platformUserId": "user_001", "nickname": "张三", "tagName": "平面设计", "executionCount": 320, "avgRating": 4.8 },
{ "platformUserId": "user_002", "nickname": "李四", "tagName": "视频剪辑", "executionCount": 89, "avgRating": 4.6 }
]
}填入 appKey / appSecret 与请求体，下方实时算出 timestamp、HMAC-SHA256 签名和完整 Authorization Header。计算全程在本地完成，密钥不会离开你的浏览器。
提示：实际请求中 requestBody 必须与计算签名时使用的字符串完全一致（含空格与字段顺序），建议直接使用序列化后的原始字符串。
群星根据累计完成数和平均评分自动计算等级。
| 等级 | 条件 | 说明 |
|---|---|---|
| S1 | 默认 | 首次绑定即为 S1 |
| S2 | 完成 ≥ 100 次，评分 ≥ 4.5 | 自动晋升 |
| S3 | 完成 ≥ 500 次，评分 ≥ 4.7 | 自动晋升 |
| S4 | 完成 ≥ 1000 次，评分 ≥ 4.8 | 外部免审核最高等级 |
| S5–S6 | — | 需在群星平台内积累，不支持外部导入 |
接入时提供回调 URL，用户等级变化时群星将向你推送：
{
"event": "rank_upgraded",
"platformUserId": "your_user_id_12345",
"aidanfupiId": "QX7281940023",
"oldRank": "S1",
"newRank": "S2",
"executionCount": 100,
"timestamp": "2026-06-17T15:00:00+08:00"
}| code | 含义 |
|---|---|
0 | 成功（重复订单时 orderRecorded=false 且 duplicate=true，幂等不重复计数） |
40001 | 签名验证失败 / 时间戳过期 |
40002 | appKey 无效或已停用 |
40003 | 参数校验失败 |
40920 | 请求频率超限 |
50000 | 服务端错误 |
| 套餐 / 环境 | QPS 配额 |
|---|---|
| 测试环境（test） | 20 次/秒 |
| 生产 · 开发/成长版 | 100–300 次/秒 |
| 生产 · 商业版 | 1000 次/秒 |
| 企业版 | 定制 |
QPS 按应用配额统一计算，超限返回 40920。需要更高配额可在控制台申请或联系商务。
import hmac, hashlib, time, json, requests APP_KEY = "your_app_key" APP_SECRET = "your_app_secret" BASE_URL = "https://api.qunxing.app/open-api/v1" def sync(platform_user_id, nickname, tag_name, order_id, title, amount, rating=5): body = json.dumps({ "platformUserId": platform_user_id, "nickname": nickname, "tagName": tag_name, "order": { "externalOrderId": order_id, "title": title, "amount": amount, "buyerRating": rating } }) ts = str(int(time.time() * 1000)) sig = hmac.new(APP_SECRET.encode(), f"{APP_KEY}\n{ts}\n{body}".encode(), hashlib.sha256).hexdigest() return requests.post(f"{BASE_URL}/sync", data=body, headers={ "Authorization": f"Bearer {APP_KEY}:{ts}:{sig}", "Content-Type": "application/json" }).json() # 用户完成一单时调用 print(sync("user_123", "张三", "电商运营", "ORDER_001", "手机壳定制", 29.9, 5))