docs: correct htsy API field types, names, and CLI examples

2026-07-02 09:29:31 +08:00
parent 1f4a00a0b0
commit 7d9f09c0bf
8 changed files with 92 additions and 71 deletions
@@ -30,8 +30,8 @@ htsy-cli register --username PHONE --password PASS --sms-code CODE
 | --- | --- | --- | --- |
 | 账号信息 | `POST /api/account/info` | `{}` | `id`(int64)；`phone`(string)；`main`(bool，是否是主账号)；`cfg`(CfgItem，账号配置)；`clientType`(string，客户端类型)；`clientDownloadUrl`(string，客户端下载地址)；`isDistributor`(bool，是否是渠道商)；`agreeTerms`(bool，是否同意条款 false) |
 | 登录 | `POST /api/account/login/in` | `phone`(string, 必填)；`password`(string, 可选，密码登录)；`code`(string, 可选，验证码登录) | `token`(string) |
-| 设置账号配置 | `POST /api/account/cfg/set` | `singleDel`(bool, 必填，false 手动 true 自动)；`singleCronNum`(int64, 必填，定时单删的好友上限 默认全部删除)；`singleDelEvent`(bool, 必填，false 不执行， true执行)；`singleBlacklistDel`(bool, 必填，被客户加入黑名单 是否定时删除 false 手动， true 自动)；`singleBlacklistNum`(int64, 必填，定时删除被客户加入黑名单的客户上线 默认全部删除)；`singleBlacklistEvent`(bool, 必填，被客户加入黑名单时删除客户 false 不执行， true执行)；`botIds`(repeated int64, 可选，生效的微号id)；`botRangeType`(string, 可选，all 所有 specify 指定)；`isSendMsg`(bool, 可选，删除前是否发送消息)；`messageList`(repeated Message, 可选，消息列表)；`schedule`(Schedule, 可选，删除时间)；`frequency`(Frequency, 可选，频率设置)；`isSendFriendApply`(bool, 可选，删除前是否发送好友申请)；`verifyContent`(string, 可选，好友申请的文本)；`qwQueueCfg`(QueueCfg, 可选，企微队列配置)；`wxQueueCfg`(QueueCfg, 可选，企微队列配置)；`localBotSyncTagCfg`(LocalBotSyncTagCfg, 可选，本地微号同步标签配置) | 空对象或无业务数据 |
-| 检查这个手机号是否属于海豚账号 | `POST /api/account/check/phone` | `phone`(string, 可选)；`num`(int64, 可选)；`botType`(int32, 可选)；`codeType`(int32, 可选) | `flag`(bool)；`accountId`(int64)；`darkToken`(string)；`price`(float) |
+| 设置账号配置 | `POST /api/account/cfg/set` | `singleDel`(bool, 必填，false 手动 true 自动)；`singleCronNum`(int64, 必填，定时单删的好友上限 默认全部删除)；`singleDelEvent`(bool, 必填，false 不执行， true执行)；`singleBlacklistDel`(bool, 必填，被客户加入黑名单 是否定时删除 false 手动， true 自动)；`singleBlacklistNum`(int64, 必填，定时删除被客户加入黑名单的客户上限 默认全部删除)；`singleBlacklistEvent`(bool, 必填，被客户加入黑名单时删除客户 false 不执行， true执行)；`botIds`(repeated int64, 可选，生效的微号id)；`botRangeType`(string, 可选，all 所有 specify 指定)；`isSendMsg`(bool, 可选，删除前是否发送消息)；`messageList`(repeated Message, 可选，消息列表)；`schedule`(Schedule, 可选，删除时间)；`frequency`(Frequency, 可选，频率设置)；`isSendFriendApply`(bool, 可选，删除前是否发送好友申请)；`verifyContent`(string, 可选，好友申请的文本)；`qwQueueCfg`(QueueCfg, 可选，企微队列配置)；`wxQueueCfg`(QueueCfg, 可选，个微队列配置)；`localBotSyncTagCfg`(LocalBotSyncTagCfg, 可选，本地微号同步标签配置) | 空对象或无业务数据 |
+| 检查这个手机号是否属于海豚账号 | `POST /api/account/check/phone` | `phone`(string, 可选)；`num`(int64, 可选)；`botType`(int32, 可选，1 个微 2 企微)；`codeType`(int32, 可选，1 客户端 2 协议) | `flag`(bool)；`accountId`(int64)；`darkToken`(string)；`price`(float) |
 | 账号级白名单配置详情 | `POST /api/account/whiteList/info` | `{}` | `groupIds`(repeated int64，个微白名单群) |
 | 账号级白名单配置更新 | `POST /api/account/whiteList/update` | `groupIds`(repeated int64, 必填，个微白名单群) | 空对象或无业务数据 |
 | 资源包列表 | `POST /api/account/resource/list` | `{}` | `list`(repeated ResourcePackageInfoReply，资源包类型) |
@@ -51,7 +51,7 @@ htsy-cli register --username PHONE --password PASS --sms-code CODE
 | 删除子账号 | `POST /api/account/user/delete` | `id`(int64, 必填，子账号id) | 空对象或无业务数据 |
 | 用户账号登录 | `POST /api/account/user/login/in` | `username`(string, 必填，子账号用户名 xxx@主账号手机号)；`password`(string, 必填，密码) | `token`(string，token) |
 | 用户账号登出 | `POST /api/account/user/login/logout` | `{}` | 空对象或无业务数据 |
-| 子账号列表 | `POST /api/account/user/list` | `page`(int64, 必填，page)；`pageSize`(int64, 必填，pageSize)；`roleId`(int64, 可选，角色的ID) | `list`(repeated HttpUserInfo，组内群列表)；`page`(int64，page)；`pageSize`(int64，pageSize)；`total`(int64，total)；`last`(bool，last) |
+| 子账号列表 | `POST /api/account/user/list` | `page`(int64, 必填，page)；`pageSize`(int64, 必填，pageSize)；`roleId`(int64, 可选，角色的ID) | `list`(repeated HttpUserInfo，子账号列表)；`page`(int64，page)；`pageSize`(int64，pageSize)；`total`(int64，total)；`last`(bool，last) |
 | 修改密码 | `POST /api/account/user/password/modify` | `oldPassword`(string, 可选，旧密码)；`newPassword`(string, 可选)；`code`(string, 可选，验证码修改)；`phone`(string, 可选，获取验证码的手机号) | 空对象或无业务数据 |
 | 获取登录二维码 | `POST /api/account/user/login/qrCode` | `{}` | `link`(string，二维码链接)；`code`(string，回调code) |
 | 扫码回调 | `POST /api/account/user/login/scan/callback` | `code`(string, 必填，回调code) | `success`(bool，是否成功)；`list`(repeated AccountUser，多账号列表) |
@@ -67,7 +67,7 @@ htsy-cli register --username PHONE --password PASS --sms-code CODE
 | 发送短信验证码 | `POST /api/account/user/phone/sendCode` | `phone`(string, 必填，手机号码)；`scene`(string, 必填，场景 注册 register 修改密码 resetPwd 登录 login 绑定手机号 bind) | 空对象或无业务数据 |
 | 设置密码 | `POST /api/account/user/setPassword` | `password`(string, 必填，设置密码) | 空对象或无业务数据 |
 | 关联手机号码 | `POST /api/account/bindPhone` | `phone`(string, 必填，手机号码)；`smsCode`(string, 必填，短信验证码) | 空对象或无业务数据 |
-| 获取客服子账号 | `POST /api/account/customer/list` | `{}` | `list`(repeated HttpUserInfo，组内群列表) |
+| 获取客服子账号 | `POST /api/account/customer/list` | `{}` | `list`(repeated HttpUserInfo，客服子账号列表) |


 ## 席位管理
@@ -115,7 +115,7 @@ htsy-cli register --username PHONE --password PASS --sms-code CODE
 | 用余额完成订单 | `POST /api/account/order/complete/byBalance` | `orderId`(string, 必填，订单id) | 空对象或无业务数据 |
 | 用订单创建微信支付订单 | `POST /api/account/order/complete/byWxPay` | `orderId`(string, 必填，订单id)；`openid`(string, 必填，openid) | `payInfo`(google.protobuf.Value，微信支付信息) |
 | 账号金额明细 | `POST /api/account/order/record/list` | `page`(int64, 可选)；`pageSize`(int64, 可选)；`payType`(string, 可选，支付类型：余额：balance 微信：wx)；`incomeOrExpense`(int64, 可选，0:全部 1 收入 2 支出) | `list`(repeated RecordItem)；`total`(int64)；`last`(bool)；`page`(int64)；`pageSize`(int64) |
-| 各个产品的价格 | `POST /api/account/product/prices` | `{}` | `list`(repeated Product，全功能 1 个微协议 2 个微客户端 3 企微协议 4 企微客户端 发单 5 企微协议 6企微客户端) |
+| 各个产品的价格 | `POST /api/account/product/prices` | `{}` | `list`(repeated Product，全功能：1 个微协议 2 个微客户端 3 企微协议 4 企微客户端；发单：5 企微协议 6 企微客户端) |
 | 充值余额 | `POST /api/account/recharge/balance` | `accountId`(int64, 可选)；`auth`(string, 可选)；`money`(double, 可选) | 空对象或无业务数据 |
 | 代理商-转账 | `POST /api/account/transfer/balance` | `phone`(string, 可选)；`money`(double, 可选) | 空对象或无业务数据 |
 | 使用微信支付充值余额 | `POST /api/account/recharge/wxPay` | `money`(double, 可选) | `qrCode`(string，微信支付的时候存在 二维码)；`orderId`(string，订单id)；`price`(double，实付价)；`originPrice`(double，原价)；`payType`(int32，支付类型 1 余额 2 微信支付)；`totalAmount`(double，到账总价)；`tables`(google.protobuf.Value，表格名字) |
@@ -135,6 +135,6 @@ htsy-cli register --username PHONE --password PASS --sms-code CODE
 ```bash
 htsy-cli call /api/account/info -d '{}'
 htsy-cli call /api/account/user/list -d '{"page":1,"pageSize":20}'
-htsy-cli call /api/account/bot/list -d '{"page":1,"pageSize":20,"botType":1}'
+htsy-cli call /api/account/bot/list -d '{"page":1,"pageSize":20,"botType":2,"sort":0}'   # botType: 1 个微 2 企微；sort: 0默认 1过期升序 2过期降序
 htsy-cli call /api/account/role/list -d '{}'
 ```