docs: correct htsy API field types, names, and CLI examples
This commit is contained in:
dcsunny
@@ -17,7 +17,7 @@
|
||||
| 黑名单数据包-客户列表 | `POST /api/wx/friend/blacklist/package/friendList` | `page`(int64, 必填，分页page)；`pageSize`(int64, 必填，分页pageSize)；`packageId`(int64, 必填，包id)；`wxid`(string, 可选，好友的wxid)；`nickName`(string, 可选，好友的昵称) | `list`(repeated BlacklistInfo，客户信息)；`page`(int64)；`pageSize`(int64)；`total`(int64，总数)；`last`(bool，是否最后一页) |
|
||||
| 客户列表 | `POST /api/wx/friend/list` | `page`(int64, 必填，分页page)；`pageSize`(int64, 必填，分页pageSize)；`name`(string, 可选，昵称搜索)；`botType`(int32, 必填，类型 1 个微 2企微)；`ids`(repeated int64, 可选，ids，客户ids)；`botId`(int64, 可选，机器人id)；`botIds`(repeated int64, 可选，机器人ids)；`corpId`(string, 必填，主体id)；`filters`(repeated TargetFilter, 可选，多筛选条件，且的关系)；`inTagIds`(repeated int64, 可选，包含标签ids)；`notInTagIds`(repeated int64, 可选，排除标签ids)；`inQwTagIds`(repeated string, 可选，包含企微标签ids)；`notInQwTagIds`(repeated string, 可选，排除企微标签ids)；`threePartyService`(string, 可选，三方服务过滤部分字段使用)；`groupRange`(repeated int64, 可选，所属群聊)；`friendType`(int32, 可选，客户类型 1 个微 2 企微) | `list`(repeated FriendInfo，客户信息)；`page`(int64)；`pageSize`(int64)；`total`(int64)；`last`(bool) |
|
||||
| 通过客户wxId获取客户信息 | `POST /api/wx/friend/list/byWxid` | `wxids`(repeated string, 可选) | `list`(repeated FriendInfo，客户信息) |
|
||||
| 客户详情 | `POST /api/wx/friend/get` | `id`(int64, 必填，客户的id)；`botType`(int64, 必填，个微还是企微)；`botId`(int64, 可选，机器人id)；`corpId`(string, 可选，主体id) | `id`(int64，id)；`nickname`(string，昵称)；`avatar`(string，头像)；`wxid`(string，客户的wxid)；`tagList`(repeated api.wx.wxgatewayfriendTag.Tag，标签列表)；`sex`(int32，性别)；`remark`(string，备注)；`isBlack`(bool，是否是黑名单)；`botFriendInfoList`(repeated FriendInfoByBot，和微号相关的信息)；`groupFriendInfoList`(repeated FriendInfoByGroup，和群相关的信息)；... |
|
||||
| 客户详情 | `POST /api/wx/friend/get` | `id`(int64, 必填，客户的id)；`botType`(int32, 必填，个微还是企微)；`botId`(int64, 可选，机器人id)；`corpId`(string, 可选，主体id) | `id`(int64，id)；`nickname`(string，昵称)；`avatar`(string，头像)；`wxid`(string，客户的wxid)；`tagList`(repeated api.wx.wxgatewayfriendTag.Tag，标签列表)；`sex`(int32，性别)；`remark`(string，备注)；`isBlack`(bool，是否是黑名单)；`botFriendInfoList`(repeated FriendInfoByBot，和微号相关的信息)；`groupFriendInfoList`(repeated FriendInfoByGroup，和群相关的信息)；... |
|
||||
| 同步客户列表 | `POST /api/wx/friend/manualSync` | `botIds`(repeated int64, 必填，机器人id列表)；`botType`(int32, 必填，类型 1 个微 2企微) | 空对象或无业务数据 |
|
||||
| 同步内部联系人(仅限企微号) | `POST /api/wx/friend/inner/manualSync` | `botIds`(repeated int64, 必填，机器人id列表)；`botType`(int32, 必填，类型 1 个微 2企微) | 空对象或无业务数据 |
|
||||
| 内部联系人列表(仅限企微号) | `POST /api/wx/friend/inner/list` | `page`(int64, 必填，分页page)；`pageSize`(int64, 必填，分页pageSize)；`botType`(int32, 必填，类型 1 个微 2企微)；`ids`(repeated int64, 可选，ids，客户ids)；`wxids`(repeated string, 可选，wxids)；`corpId`(string, 可选，主体id)；`name`(string, 可选，按名称搜索) | `list`(repeated InnerFriendItem，内部联系人信息)；`page`(int64)；`pageSize`(int64)；`total`(int64)；`last`(bool) |
|
||||
@@ -25,18 +25,18 @@
|
||||
| 内部联系人删除(仅限企微号) | `POST /api/wx/friend/inner/del` | `wxid`(string, 必填，id)；`corpId`(string, 必填，corpId) | 空对象或无业务数据 |
|
||||
| 内部联系人更新(仅限企微号) | `POST /api/wx/friend/inner/update` | `id`(int64, 必填，id)；`nickname`(string, 必填，昵称)；`avatar`(string, 可选，头像)；`wxid`(string, 必填，客户的wxid)；`sex`(int32, 可选，性别)；`corpId`(string, 可选，主体id) | 空对象或无业务数据 |
|
||||
| 同步通信录 | `POST /api/wx/friend/contacts/sync` | `botIds`(repeated int64, 必填，机器人id)；`botType`(int32, 必填，类型 1 个微 2企微) | `list`(repeated SyncContactItem) |
|
||||
| 客户备注 | `POST /api/wx/friend/remark/set` | `friendId`(int64, 必填，客户id)；`remark`(string, 必填，备注)；`botType`(int64, 必填，个微还是企微)；`botId`(int64, 必填，微号id) | 空对象或无业务数据 |
|
||||
| 客户备注 | `POST /api/wx/friend/remark/set` | `friendId`(int64, 必填，客户id)；`remark`(string, 必填，备注)；`botType`(int32, 必填，个微还是企微)；`botId`(int64, 必填，微号id) | 空对象或无业务数据 |
|
||||
| 客户拉黑企微 - 列表 | `POST /api/wx/friend/single/blacklist/list` | `page`(int64, 必填，分页page)；`pageSize`(int64, 必填，分页pageSize)；`botType`(int32, 必填，类型 1 个微 2企微)；`botIds`(repeated int64, 可选，机器人ids)；`corpId`(string, 可选，主体id)；`nickname`(string, 可选，客户昵称筛选) | `list`(repeated HttpSingleBlackFriendItem，客户信息)；`page`(int64)；`pageSize`(int64)；`total`(int64)；`last`(bool) |
|
||||
| 客户拉黑企微-删除 | `POST /api/wx/friend/single/blacklist/del` | `ids`(repeated int64, 必填，客户微号的id) | 空对象或无业务数据 |
|
||||
| 单向客户列表 | `POST /api/wx/friend/singleList` | `page`(int64, 必填，分页page)；`pageSize`(int64, 必填，分页pageSize)；`botType`(int32, 必填，类型 1 个微 2企微)；`botIds`(repeated int64, 可选，机器人ids)；`nickname`(string, 可选，客户昵称筛选)；`corpId`(string, 可选，主体id)；`addTimeStart`(int64, 可选，添加时间开始)；`addTimeEnd`(int64, 可选，添加时间结束)；`timeStart`(int64, 可选，流失时间开始)；`timeEnd`(int64, 可选，流失时间结束) | `list`(repeated HttpSingleFriendListItem，客户信息)；`page`(int64)；`pageSize`(int64)；`total`(int64)；`last`(bool) |
|
||||
| 单向客户同步 | `POST /api/wx/friend/single/sync` | `botId`(int64, 必填，微号id)；`botType`(int64, 必填，微号类型) | 空对象或无业务数据 |
|
||||
| 单向客户同步 | `POST /api/wx/friend/single/sync` | `botId`(int64, 必填，微号id)；`botType`(int32, 必填，微号类型) | 空对象或无业务数据 |
|
||||
| 单向客户删除 | `POST /api/wx/friend/single/del` | `ids`(repeated int64, 必填，客户微号的id) | 空对象或无业务数据 |
|
||||
| 客户删除 | `POST /api/wx/friend/deleteFriend` | `ids`(repeated int64, 必填，ids)；`botId`(int64, 必填，botId)；`botType`(int32, 必填，微号类型) | 空对象或无业务数据 |
|
||||
| 企微删除客户记录 - 列表 | `POST /api/wx/friend/del/recordList` | `page`(int64, 必填，分页page)；`pageSize`(int64, 必填，分页pageSize)；`botType`(int32, 必填，类型 1 个微 2企微)；`botIds`(repeated int64, 可选，机器人ids)；`corpId`(string, 可选，主体id)；`nickname`(string, 可选，客户昵称筛选) | `list`(repeated HttpSingleFriendListItem，客户信息)；`page`(int64)；`pageSize`(int64)；`total`(int64)；`last`(bool) |
|
||||
| 单向客户删除记录 | `POST /api/wx/friend/single/delRecord` | `ids`(repeated int64, 必填，客户微号的id) | 空对象或无业务数据 |
|
||||
| 被动黑名单删除记录 | `POST /api/wx/friend/single/blacklist/delRecord` | `ids`(repeated int64, 必填，客户微号的id) | 空对象或无业务数据 |
|
||||
| 获取客户和群成员信息 | `POST /api/wx/friendAndGroup/info` | `friendAndGroupWxid`(repeated string, 必填，客户和群成员的wxid)；`botType`(int64, 必填，微号类型) | `list`(repeated FriendAndGroupInfo) |
|
||||
| 获取客户的所属群信息 | `POST /api/wx/friend/info/group` | `ids`(repeated int64, 必填，客户的id)；`botType`(int64, 必填，微号类型) | `list`(repeated FriendGroupInfoItem) |
|
||||
| 获取客户和群成员信息 | `POST /api/wx/friendAndGroup/info` | `friendAndGroupWxid`(repeated string, 必填，客户和群成员的wxid)；`botType`(int32, 必填，微号类型) | `list`(repeated FriendAndGroupInfo) |
|
||||
| 获取客户的所属群信息 | `POST /api/wx/friend/info/group` | `ids`(repeated int64, 必填，客户的id)；`botType`(int32, 必填，微号类型) | `list`(repeated FriendGroupInfoItem) |
|
||||
| 获取客户昵称头像信息 | `POST /api/wx/friend/baseInfo/byWxids` | `botType`(int32, 必填，微号类型)；`wxids`(repeated string, 必填，wxids) | `list`(repeated FriendBaseInfo) |
|
||||
|
||||
|
||||
@@ -80,8 +80,12 @@
|
||||
## 常用示例
|
||||
|
||||
```bash
|
||||
htsy-cli call /api/wx/friend/list -d '{"page":1,"pageSize":20,"botType":1,"botId":1001}'
|
||||
htsy-cli call /api/wx/friend/get -d '{"id":2002,"botType":1}'
|
||||
htsy-cli call /api/wx/friend/remark/set -d '{"id":2002,"remark":"重要客户","botType":1}'
|
||||
htsy-cli call /api/wx/friend/tag/list -d '{"page":1,"pageSize":50,"botType":1}'
|
||||
# 客户列表（企微 botType:2 必传 corpId；CORP_ID 可从 /api/bot/wx/corp/list 返回项的 id 获取）
|
||||
htsy-cli call /api/wx/friend/list -d '{"page":1,"pageSize":20,"botType":2,"corpId":"CORP_ID"}'
|
||||
# 客户详情
|
||||
htsy-cli call /api/wx/friend/get -d '{"id":2002,"botType":2}'
|
||||
# 设置客户备注（字段是 friendId 不是 id；botId 必填）
|
||||
htsy-cli call /api/wx/friend/remark/set -d '{"friendId":2002,"remark":"重要客户","botType":2,"botId":1001}'
|
||||
# 标签列表
|
||||
htsy-cli call /api/wx/friend/tag/list -d '{"page":1,"pageSize":50,"botType":2}'
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user