Flutter TIM 项目实现

news2024/11/19 17:47:59

目录

1. 服务端API

1.1 生成签名

1.1.1 步骤

第一步：获取签名算法

第二步：查看函数输入输出

第三步：nodejs 实现功能

1.1.2 验证签名

小结

1.2 Rest API 调用

1.2.1 签名介绍

1.2.2 腾讯接口

生成管理员 administrator 签名

包装一个 post 请求函数

查询账号

导入单个账号

导入多个账号，一次最多导入 100 个账号

设置用户资料

获取群详细资料

删除群聊

在群组中发送系统通知

小结

1.3 第三方回调

1.3.1 场景举例

1.3.2 回调命令列表

在线状态

资料关系链

单聊消息

群组系统

1.3.3 配置回调

第一步：配置回调服务器

第二步：第三方回调配置

小结

2. IM 用户登录

2.1 类结构设计

2.1.1 正文

类架构图

类设计说明

2.1.2 小结

2.2 工具类 IMManager

重要说明

2.2.1 步骤

常量 Constants

状态枚举，类

SDK 初始化

事件监听 Listener

用户 User

会话 Conversasion

消息 Message

群组 Group

小结

2.3 服务 IMService

2.3.1 关系结构

2.3.2 步骤

创建 IMService

导包

加入 TIM 管理器

初始化 init

SDK 

用户

消息

群聊

会话

小结

2.4 断线重连处理

2.4.1 知识点

断线重连

技术处理

2.4.2 步骤

全局初始 IMService

启动 APP 连接成功

断开网络

恢复网络自动断线重连

小结

2.5 用户登录，登出

2.5.1 用户管理

2.5.2 步骤

保存令牌

用户登录

离线用户登录

用户退出

http 401 授权错误

腾讯后台账号管理

小结

2.6 用户登录过期

2.6.1 知识点

令牌过期

2.6.2 处理过程

2.6.3 步骤

处理 V2TIMListener -> onUserSigExpired 过期回调

小结

2.7 多端登录踢下线

2.7.1 步骤

腾讯云后台配置

i18n 多语言

处理 oKickedOffline 回调

效果

小结

2.8 会话响应 IM 状态

2.8.1 步骤

多语言 i18n

会话首页

浮动提示栏组件

IMService 服务器，用户状态

IM 登录

监听服务器离线

小结

3. 聊天用户选取

3.1 用户列表

3.1.1 步骤

搜索用户 api

控制器翻页拉取用户

视图页刷新控制

会话页面发起选择用户

小结

3.2 选择用户

3.2.1 步骤

选取用户控制器

选取用户视图

会话界面接收选中列表数据

小结

4. 单聊功能

4.1 聊天界面布局

4.1.1 步骤

创建聊天业务

导包

聊天控制器

进入聊天

小结

4.2 底部聊天栏位

4.2.1 步骤

聊天栏 ChaBarWidget

聊天 Chat 控制器

聊天 Chat 视图

小结

4.3 发送文字消息

4.3.1 知识点

SDK 函数和类型

V2TimMessage.tatus 消息状态

V2TimMessage.elemType 消息类型

4.3.2 步骤

聊天控制器

聊天视图

小结

4.4 接收显示文字消息

4.4.1 SDK API 接口

 getC2CHistoryMessageList 获取单聊历史消息

getGroupHistoryMessageList 获取群组历史消息

4.4.2 类结构

4.4.3 步骤

聊天控制器

聊天视图

IMService 服务

小结

4.5 发送失败消息处理

4.5.1 步骤

i18n多语言

删除不合规消息

重新发送消息

显示错误信息

小结

5. 会话管理

5.1 会话列表

5.1.1 会话接口说明

5.1.2 步骤

会话控制器

会话视图

小结

5.2 更新会话

5.2.1 步骤

会话控制器

会话视图

IM 工具类

IM 会话监听更新

小结

6. 群聊功能

6.1 创建群聊

6.1.1 createGroup 接口说明

6.1.2 步骤

会话控制器

聊天控制器

小结

6.2 群本地消息

insertGroupMessageToLocalStorage 接口说明

V2TimMessage.elemType 消息类型

步骤

消息枚举定义

IMService 服务

会话控制器创建本地消息

聊天控制器

聊天视图

小结

6.3 群提示消息

6.3.1 接口说明

消息内容

V2TimGroupTipsElem.type 群Tips类型

6.3.2 步骤

定义消息枚举

消息类型转字符串

聊天界面显示提示

小结

6.4 群管理侧栏

6.4.1 步骤

群设置组件

聊天控制器

聊天视图

小结

6.5 修改群资料

6.5.1 接口说明

入参

6.5.2 步骤

聊天控制器

群设置侧栏组件

IM 工具类

IMService 群消息处理

小结

6.6 邀请加入

6.6.1 接口说明

入参

返回值

6.6.2 步骤

聊天控制器

群聊侧栏管理组件

小结

6.7 踢出群聊

6.7.1 kickGroupMember 接口说明

入参

6.7.2 步骤

聊天控制器

侧栏视图

IMService 服务

聊天界面系统消息

小结

6.8 退出群聊

6.8.1 quitGroup 接口说明

入参

6.8.2 步骤

im 工具类

imservice

聊天控制器

聊天侧栏

聊天视图

小结

6.9 解散群聊

6.9.1 解散群逻辑

6.9.2 接口说明

FLUTTER SDK dismissGroup 接口

服务器端 destroy_group 接口

6.9.3 步骤

IM 工具类

IMService

聊天控制器

聊天侧栏

会话控制器

小结

7. 信息提示

7.1 未读信息提示

7.1.1 步骤

IMService

main 主视图

IM Manager

聊天控制器

小结

7.2 APP 内提示

7.2.1步骤

overlay_support 插件安装

IM 工具类

IMService

小结

7.3 本机提示

7.3.1 步骤

flutter_local_notifications 包

ios 配置

android 配置

本地消息服务

IM 工具类

ConfigService 配置服务

IMService 腾讯聊天服务类

main 控制器

main 视图

小结

博主wx：yuanlai45_csdn 博主qq：2777137742

后期会创建粉丝群，为同学们提供分享交流平台以及提供官方发送的福利奖品~

PS：重新清理依赖，在拷贝新项目的时候用得上

flutter clean

flutter pub get

1. 服务端API

1.1 生成签名

与腾讯通讯时需要带上 UserSig 签名参数，这个是标识这个用户访问被允许，所以这是必须要做的事情。

签名的方式有两种，一个是客户端签名，这种方式缺点容易被反编译后复制出密钥。

另一种方式是服务端签名，虽然消耗点服务器资源，但是这种比较安全。这是推荐的方式。

本文将会以 nodejs 作为后端，来说明签名过程。毕竟 js 语法大家容易理解。

1.1.1 步骤

第一步：获取签名算法

资料 即时通信 IM 生成 UserSig-服务端 API-文档中心-腾讯云

采用服务端计算 UserSig，可以最大限度地保障计算 UserSig 所用的密钥信息不被泄露。您只需将计算代码部署在您的服务器上，并提供面向 App 的服务端接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。 为了简化实现过程，我们提供了下列语言或平台的 UserSig 计算源码，您可以直接下载并集成到您的服务端。

语言版本 关键函数 下载链接
Java HMAC-SHA256 genSig
GO HMAC-SHA256 GenSig
PHP HMAC-SHA256 genSig
Nodejs(这个) HMAC-SHA256 genSig
Python HMAC-SHA256 gen_sig
C# HMAC-SHA256 GenSig
C++ HMAC-SHA256 gen_sig

第二步：查看函数输入输出

资料 tls-sig-api-v2-node/TLSSigAPIv2.js at master · tencentyun/tls-sig-api-v2-node · GitHub

初始化签名对象，传入 appid, key 密钥

...
var Api = function (sdkappid, key) {
    this.sdkappid = sdkappid;
    this.key = key;
};
...

签名函数，传入 userid 用户编号，expire 过期时间秒，userBuf 默认 null 只有在音视频时才用上

Api.prototype.genSig = function (userid, expire, userBuf) {
    var currTime = Math.floor(Date.now() / 1000);

    var sigDoc = {
        'TLS.ver': "2.0",
        'TLS.identifier': "" + userid,
        'TLS.sdkappid': Number(this.sdkappid),
        'TLS.time': Number(currTime),
        'TLS.expire': Number(expire)
    };

    var sig = '';
    if (null != userBuf) {
        var base64UserBuf = base64encode(userBuf);
        sigDoc['TLS.userbuf'] = base64UserBuf;
        sig = this._hmacsha256(userid, currTime, expire, base64UserBuf);
    } else {
        sig = this._hmacsha256(userid, currTime, expire, null);
    }
    sigDoc['TLS.sig'] = sig;

    var compressed = zlib.deflateSync(newBuffer(JSON.stringify(sigDoc))).toString('base64');
    return base64url.escape(compressed);
}

第三步：nodejs 实现功能

配置环境变量 env

.env

# tim
tim_server=console.tim.qq.com
tim_appid=1400803542
tim_key=密钥xxxxxxxxxxxxxxxxxx

初始签名对象

// 腾讯 tim
const tim = new TLSSigAPIv2.Api(config.tim_appid, config.tim_key);
fastify.decorate("tim", tim);

生成 UserSig 签名        

// tim 签名
const im_sign_expire = 31536000; // 365天
const im_sign = await this.tim.genSig(username, im_sign_expire);

使用 apifox 来测试

下载链接Apifox - API 文档、调试、Mock、测试一体化协作平台。拥有接口文档管理、接口调试、Mock、自动化测试等功能，接口开发、测试、联调效率，提升 10 倍。最好用的接口文档管理工具，接口自动化测试工具。

调用 /users/me 接口

客户端保存好你的 im_sign 。

1.1.2 验证签名

登录 - 腾讯云

输入 userid, 签名 sig, 点击开始校验，输出签名信息查看。

果然有效期是 365 天

小结

本节讲了腾讯签名令牌的后端实现方式，业务里面放在了获取用户资料的接口里面，因为我本来就要用 userid 去查询下数据库，这样就一起返回数据了。

如果发现不能登录、提示签名错误的，可以在腾讯后台点击开始校验看下是否签名正确。

apifox接口——可直接在项目设置选择apifix格式导入

{"apifoxProject":"1.0.0","$schema":{"app":"apifox","type":"project","version":"1.2.0"},"info":{"name":"猫哥视频站-课程","description":"","mockRule":{"rules":[],"enableSystemRule":true}},"responseCollection":[],"apiCollection":[{"name":"根目录","parentId":0,"serverId":"","description":"","preProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"postProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"identityPattern":{"httpApi":{"type":"methodAndPath","bodyType":""}},"items":[{"name":"用户","parentId":0,"serverId":"","description":"","preProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"postProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"identityPattern":{"httpApi":{"type":"inherit","bodyType":"","fields":[]}},"items":[{"name":"注册","api":{"id":"75406090","method":"post","path":"/users/register","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834219","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"x-apifox-orders":["id"]}}],"responseExamples":[{"name":"成功示例 ","data":"{\n    \"id\": \"7\"\n}","responseId":190834219,"ordering":1}],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{"username":{"type":"string","mock":{"mock":"ducafecat"},"title":""},"password":{"type":"string","mock":{"mock":"123456"}},"email":{"type":"string","mock":{"mock":"ducafecat@gmail.com"}},"verify_code":{"type":"string"}},"x-apifox-orders":["username","password","email","verify_code"],"required":["username","password","email","verify_code"]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":0,"cases":[{"id":81441640,"type":"http","path":null,"name":"成功","responseId":190834219,"parameters":{},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"type":"application/json","data":"{\n    \"username\": \"ducafecat\",\n    \"password\": \"123456\",\n    \"email\": \"ducafecat@gmail.com\"\n}"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{}}],"mocks":[],"customApiFields":"{}","advancedSettings":{},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"获取 Email 验证码","api":{"id":"75406088","method":"post","path":"/users/verify","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834216","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{},"x-apifox-orders":[]}}],"responseExamples":[],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{"email":{"type":"string","mock":{"mock":"ducafecat@gmail.com"}},"type":{"type":"string","description":"register, findPassword"}},"x-apifox-orders":["email","type"],"required":["email","type"]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":6,"cases":[],"mocks":[],"customApiFields":"{}","advancedSettings":{},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"找回密码","api":{"id":"75406091","method":"post","path":"/users/findpwd","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834218","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{},"x-apifox-orders":[]}}],"responseExamples":[],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{"email":{"type":"string","mock":{"mock":"ducafecat@gmail.com"}},"verify_code":{"type":"string","description":"验证码"},"password":{"type":"string","description":"密码"}},"x-apifox-orders":["email","verify_code","password"],"required":["email","verify_code","password"]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":12,"cases":[],"mocks":[],"customApiFields":"{}","advancedSettings":{},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"加密","api":{"id":"75406087","method":"post","path":"/users/encrypt","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834215","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{},"x-apifox-orders":[]}}],"responseExamples":[],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{"password":{"type":"string","description":"密码"}},"x-apifox-orders":["password"],"required":["password"]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":18,"cases":[],"mocks":[],"customApiFields":"{}","advancedSettings":{},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"登录","api":{"id":"75406089","method":"post","path":"/users/login","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834217","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{"token":{"type":"string"},"profile":{"type":"object","properties":{"username":{"type":"string"},"email":{"type":"string"},"nick_name":{"type":"string"},"avatar":{"type":"string"},"intro":{"type":"null"},"vip_grade":{"type":"string"},"vip_expire_time":{"type":"null"},"total_times":{"type":"integer"},"last_time":{"type":"string"},"reg_time":{"type":"string"}},"required":["username","email","nick_name","avatar","intro","vip_grade","vip_expire_time","total_times","last_time","reg_time"],"x-apifox-orders":["username","email","nick_name","avatar","intro","vip_grade","vip_expire_time","total_times","last_time","reg_time"]}},"required":["token","profile"],"x-apifox-orders":["token","profile"]}}],"responseExamples":[{"name":"成功示例 ","data":"{\n    \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiNiIsImlhdCI6MTY2MDM5NzM0NSwiZXhwIjoxNjYxMDAyMTQ1fQ.KYSfIeK2Q-9PgPivIIqfIMWF0owSee6LXqoK7gk83F8\"\n}","responseId":190834217,"ordering":1}],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{"username":{"type":"string","mock":{"mock":"ducafecat@gmail.com"}},"password":{"type":"string","mock":{"mock":"kWrIeYCYAYvd3i5fUpjttlvXJC8ftNwNtIuToK9H6dh5zJdTXTA8ghZf46SWZuQn6DYBBEEzZc6FQghjssW/Kw=="}}},"x-apifox-orders":["username","password"],"required":["username","password"]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":24,"cases":[{"id":81441636,"type":"http","path":null,"name":"成功","responseId":190834217,"parameters":{},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"type":"application/json","data":"{\n    \"username\": \"ducafecat01\",\n    \"password\": \"cpVDcw/rkyPeYMeVJFa5cA7P5yuH8pI1h1U+thEdkI20Dhb5p66reU/HQHtDGZsTVXIMBLKCOtLmCZfG43m5SA==\"\n}"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{}}],"mocks":[],"customApiFields":"{}","advancedSettings":{"isDefaultUrlEncoding":1},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"Profile","api":{"id":"75406092","method":"get","path":"/users/me","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834220","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{"id":{"type":"string"},"im_sig":{"type":"string"},"username":{"type":"string"},"email":{"type":"string"},"nick_name":{"type":"string"},"avatar":{"type":"string"},"intro":{"type":"null"},"vip_grade":{"type":"string"},"vip_expire_time":{"type":"string"},"total_times":{"type":"integer"},"last_time":{"type":"string"},"reg_time":{"type":"string"},"attributes":{"type":"object","properties":{"username":{"type":"string"},"email":{"type":"string"},"nick_name":{"type":"string"},"intro":{"type":"null"},"vip_grade":{"type":"string"},"vip_expire_time":{"type":"null"},"total_times":{"type":"integer"},"ip":{"type":"null"},"country":{"type":"null"},"province":{"type":"null"},"city":{"type":"null"},"last_time":{"type":"string"},"reg_time":{"type":"string"}},"required":["username","email","nick_name","intro","vip_grade","vip_expire_time","total_times","ip","country","province","city","last_time","reg_time"],"x-apifox-orders":["username","email","nick_name","intro","vip_grade","vip_expire_time","total_times","ip","country","province","city","last_time","reg_time"]}},"required":["id","im_sig","username","email","nick_name","avatar","intro","vip_grade","vip_expire_time","total_times","last_time","reg_time","attributes"],"x-apifox-orders":["id","attributes","im_sig","username","email","nick_name","avatar","intro","vip_grade","vip_expire_time","total_times","last_time","reg_time"]}}],"responseExamples":[{"name":"成功示例 ","data":"{\n    \"id\": \"6\",\n    \"attributes\": {\n        \"username\": \"ducafecat\",\n        \"email\": \"ducafecat@gmail.com\",\n        \"nick_name\": \"ducafecat\",\n        \"intro\": null,\n        \"vip_grade\": \"guest\",\n        \"vip_expire_time\": null,\n        \"total_times\": 0,\n        \"ip\": null,\n        \"country\": null,\n        \"province\": null,\n        \"city\": null,\n        \"last_time\": \"2022-08-13T13:28:00.646Z\",\n        \"reg_time\": \"2016-07-20T12:00:15.000Z\"\n    }\n}","responseId":190834220,"ordering":1}],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{},"x-apifox-orders":[]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":30,"cases":[{"id":81441638,"type":"http","path":null,"name":"成功","responseId":190834220,"parameters":{},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"type":"application/json"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{}}],"mocks":[],"customApiFields":"{}","advancedSettings":{},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"更新 Profile","api":{"id":"75406093","method":"put","path":"/users/me","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834221","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{"id":{"type":"string"},"attributes":{"type":"object","properties":{"username":{"type":"string"},"email":{"type":"string"},"nick_name":{"type":"string"},"intro":{"type":"null"},"vip_grade":{"type":"string"},"vip_expire_time":{"type":"null"},"total_times":{"type":"integer"},"ip":{"type":"null"},"country":{"type":"null"},"province":{"type":"null"},"city":{"type":"null"},"last_time":{"type":"string"},"reg_time":{"type":"string"}},"required":["username","email","nick_name","intro","vip_grade","vip_expire_time","total_times","ip","country","province","city","last_time","reg_time"],"x-apifox-orders":["username","email","nick_name","intro","vip_grade","vip_expire_time","total_times","ip","country","province","city","last_time","reg_time"]}},"required":["id","attributes"],"x-apifox-orders":["id","attributes"]}}],"responseExamples":[{"name":"成功示例 ","data":"{\n    \"id\": \"6\",\n    \"attributes\": {\n        \"username\": \"ducafecat\",\n        \"email\": \"ducafecat@gmail.com\",\n        \"nick_name\": \"ducafecat\",\n        \"intro\": null,\n        \"vip_grade\": \"guest\",\n        \"vip_expire_time\": null,\n        \"total_times\": 0,\n        \"ip\": null,\n        \"country\": null,\n        \"province\": null,\n        \"city\": null,\n        \"last_time\": \"2022-08-13T13:28:00.646Z\",\n        \"reg_time\": \"2016-07-20T12:00:15.000Z\"\n    }\n}","responseId":190834221,"ordering":1}],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{},"x-apifox-orders":[]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":36,"cases":[],"mocks":[],"customApiFields":"{}","advancedSettings":{},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"tim 数据准备","api":{"id":"75406097","method":"post","path":"/users/chatPrepare","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834227","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{},"x-apifox-orders":[]}}],"responseExamples":[{"name":"成功示例 ","data":"{\n    \"id\": \"7\"\n}","responseId":190834227,"ordering":1}],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{"user_ids":{"type":"array","items":{"type":"string"}}},"x-apifox-orders":["user_ids"],"required":["user_ids"]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":60,"cases":[{"id":81441643,"type":"http","path":null,"name":"成功","responseId":0,"parameters":{},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"type":"application/json","data":"{\n    \"password\": \"123456\"\n}"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{}}],"mocks":[],"customApiFields":"{}","advancedSettings":{},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"tim 解散聊天群","api":{"id":"75406098","method":"post","path":"/users/chatDeleteGroup","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834226","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{},"x-apifox-orders":[]}}],"responseExamples":[],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{"userId":{"type":"string"},"groupId":{"type":"string"}},"x-apifox-orders":["userId","groupId"],"required":["userId","groupId"]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":66,"cases":[{"id":81441642,"type":"http","path":null,"name":"成功","responseId":0,"parameters":{},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"type":"application/json","data":"{\n    \"password\": \"123456\"\n}"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{}}],"mocks":[],"customApiFields":"{}","advancedSettings":{},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"用户列表","api":{"id":"75406100","method":"post","path":"/users/findList","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834228","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"attributes":{"type":"object","properties":{"username":{"type":"string"},"nick_name":{"type":"string"},"avatar":{"type":"string"}},"required":["username","nick_name","avatar"],"x-apifox-orders":["username","nick_name","avatar"]}},"required":["id","attributes"],"x-apifox-orders":["id","attributes"]}}}],"responseExamples":[{"name":"成功示例","data":"[\n    {\n        \"id\": \"186\",\n        \"attributes\": {\n            \"username\": \"bruce-bnu\",\n            \"nick_name\": \"bruce-bnu\",\n            \"avatar\": \"00258VC3ly1gty0r05zh2j60ut0u0tce02.jpg\"\n        }\n    },\n    {\n        \"id\": \"187\",\n        \"attributes\": {\n            \"username\": \"hbz_la\",\n            \"nick_name\": \"hbz_la\",\n            \"avatar\": \"00258VC3ly1gty0qy7h06j60hj0hjdhh02.jpg\"\n        }\n    },\n    {\n        \"id\": \"188\",\n        \"attributes\": {\n            \"username\": \"jiezaichan\",\n            \"nick_name\": \"jiezaichan\",\n            \"avatar\": \"00258VC3ly1gty0qzj6d9j60go0goabi02.jpg\"\n        }\n    },\n    {\n        \"id\": \"189\",\n        \"attributes\": {\n            \"username\": \"tyrSwift\",\n            \"nick_name\": \"tyrSwift\",\n            \"avatar\": \"71bdf8ebly1gty0qz6q32j20e80e8my9.jpg\"\n        }\n    },\n    {\n        \"id\": \"190\",\n        \"attributes\": {\n            \"username\": \"dy6429829\",\n            \"nick_name\": \"dy6429829\",\n            \"avatar\": \"00258VC3ly1gty0qxcj1cj609w09w3yy02.jpg\"\n        }\n    },\n    {\n        \"id\": \"191\",\n        \"attributes\": {\n            \"username\": \"leebin17\",\n            \"nick_name\": \"leebin17\",\n            \"avatar\": \"71bdf8ebly1gty1ti7lruj208c08bgm0.jpg\"\n        }\n    },\n    {\n        \"id\": \"192\",\n        \"attributes\": {\n            \"username\": \"CoderTiany\",\n            \"nick_name\": \"CoderTiany\",\n            \"avatar\": \"00258VC3ly1gty0qxcj1cj609w09w3yy02.jpg\"\n        }\n    },\n    {\n        \"id\": \"193\",\n        \"attributes\": {\n            \"username\": \"vijayh\",\n            \"nick_name\": \"vijayh\",\n            \"avatar\": \"71bdf8ebly1gty1th3xlyj20ch0cjmyb.jpg\"\n        }\n    },\n    {\n        \"id\": \"194\",\n        \"attributes\": {\n            \"username\": \"s365790504\",\n            \"nick_name\": \"s365790504\",\n            \"avatar\": \"00258VC3ly1gty0qwvax1j60gn0gngno02.jpg\"\n        }\n    },\n    {\n        \"id\": \"195\",\n        \"attributes\": {\n            \"username\": \"andy-wangzhenhua\",\n            \"nick_name\": \"andy-wangzhenhua\",\n            \"avatar\": \"00258VC3ly1gty0qyxpv1j60hj0hjtak02.jpg\"\n        }\n    },\n    {\n        \"id\": \"196\",\n        \"attributes\": {\n            \"username\": \"hasenharrison\",\n            \"nick_name\": \"hasenharrison\",\n            \"avatar\": \"00258VC3ly1gty1tgwpqvj60cj0cimyi02.jpg\"\n        }\n    },\n    {\n        \"id\": \"197\",\n        \"attributes\": {\n            \"username\": \"chenjiahui1024\",\n            \"nick_name\": \"chenjiahui1024\",\n            \"avatar\": \"00258VC3ly1gty1tgwpqvj60cj0cimyi02.jpg\"\n        }\n    },\n    {\n        \"id\": \"198\",\n        \"attributes\": {\n            \"username\": \"bjipattorney\",\n            \"nick_name\": \"bjipattorney\",\n            \"avatar\": \"71bdf8ebly1gty1th3xlyj20ch0cjmyb.jpg\"\n        }\n    },\n    {\n        \"id\": \"199\",\n        \"attributes\": {\n            \"username\": \"ljr13512765863\",\n            \"nick_name\": \"ljr13512765863\",\n            \"avatar\": \"00258VC3ly1gty0r05zh2j60ut0u0tce02.jpg\"\n        }\n    },\n    {\n        \"id\": \"200\",\n        \"attributes\": {\n            \"username\": \"jqc5656\",\n            \"nick_name\": \"jqc5656\",\n            \"avatar\": \"71bdf8ebly1gty0r1f5x4j20go0gogna.jpg\"\n        }\n    },\n    {\n        \"id\": \"201\",\n        \"attributes\": {\n            \"username\": \"subaoxiang\",\n            \"nick_name\": \"subaoxiang\",\n            \"avatar\": \"00258VC3ly1gty0r265hmj60u00u041y02.jpg\"\n        }\n    },\n    {\n        \"id\": \"202\",\n        \"attributes\": {\n            \"username\": \"XrZxHn521\",\n            \"nick_name\": \"XrZxHn521\",\n            \"avatar\": \"00258VC3ly1gty0qxmdwoj60hs0hs0tw02.jpg\"\n        }\n    },\n    {\n        \"id\": \"203\",\n        \"attributes\": {\n            \"username\": \"_shukNgan\",\n            \"nick_name\": \"_shukNgan\",\n            \"avatar\": \"00258VC3ly1gty1tgwpqvj60cj0cimyi02.jpg\"\n        }\n    },\n    {\n        \"id\": \"204\",\n        \"attributes\": {\n            \"username\": \"kevin02040\",\n            \"nick_name\": \"kevin02040\",\n            \"avatar\": \"00258VC3ly1gty1tgwpqvj60cj0cimyi02.jpg\"\n        }\n    },\n    {\n        \"id\": \"205\",\n        \"attributes\": {\n            \"username\": \"XDH2023\",\n            \"nick_name\": \"XDH2023\",\n            \"avatar\": \"00258VC3ly1gty0qxw06hj60u00u0dkf02.jpg\"\n        }\n    }\n]","responseId":190834228,"ordering":1}],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"title":"","type":"object","properties":{"keyword":{"type":"string"},"page":{"type":"integer"},"pageSize":{"type":"integer"}},"x-apifox-orders":["keyword","page","pageSize"],"required":["keyword","pageSize","page"]}},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":72,"cases":[{"id":81441645,"type":"http","path":null,"name":"成功","responseId":0,"parameters":{},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"type":"application/json","data":"{\n    \"password\": \"123456\"\n}"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{}}],"mocks":[],"customApiFields":"{}","advancedSettings":{"isDefaultUrlEncoding":1},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}}]},{"name":"博客","parentId":0,"serverId":"","description":"","preProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"postProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"identityPattern":{"httpApi":{"type":"inherit","bodyType":"","fields":[]}},"items":[{"name":"博客列表","api":{"id":"75406111","method":"get","path":"/blog","parameters":{"query":[{"required":false,"description":"页码 1","type":"integer","id":"WQTlENHs9g","example":"1","enable":true,"name":"page"},{"required":false,"description":"分类","type":"string","id":"QxVh259QPd","example":"flutter","enable":true,"name":"category"},{"required":false,"description":"查询词","type":"string","id":"Y8xke36dym","example":"","enable":true,"name":"keyword"},{"required":false,"description":"标签","type":"string","id":"Xg0Pz2Nhna","example":"","enable":true,"name":"tag"}]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834239","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"attributes":{"type":"object","properties":{"uri":{"type":"string"},"title":{"type":"string"},"keyword":{"type":"null"},"description":{"type":"string"},"tags":{"type":"string"},"cover":{"type":"string"},"pv":{"type":"integer"}},"required":["uri","title","keyword","description","tags","cover","pv"],"x-apifox-orders":["uri","title","keyword","description","tags","cover","pv"]}},"x-apifox-orders":["id","attributes"]}}}],"responseExamples":[],"requestBody":{"type":"none","parameters":[]},"description":"","tags":[],"status":"released","serverId":"","operationId":"","sourceUrl":"","ordering":0,"cases":[{"id":81441655,"type":"http","path":null,"name":"成功","responseId":190834239,"parameters":{"query":[{"id":"4WvPGW73gU","relatedId":"WQTlENHs9g","relatedName":"page","value":"1","enable":true,"isDelete":false},{"id":"eRvyxDKKwF","relatedId":"Y8xke36dym","relatedName":"keyword","value":"","enable":true,"isDelete":false},{"id":"mkSYtdT3Zb","relatedId":"QxVh259QPd","relatedName":"category","value":"flutter","enable":true,"isDelete":false},{"id":"TlWyzMx1OY","relatedId":"Xg0Pz2Nhna","relatedName":"tag","value":"","enable":true,"isDelete":false}],"path":[],"cookie":[],"header":[]},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"generateMode":"normal"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{"isDefaultUrlEncoding":1}}],"mocks":[],"customApiFields":"{}","advancedSettings":{"isDefaultUrlEncoding":1},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"博客详情","api":{"id":"75406112","method":"get","path":"/blog/{uri}","parameters":{"query":[],"path":[{"id":"uri#0","name":"uri","required":true,"description":"唯一标识","enable":true,"example":"flutter-autocomplete-debounce"}]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834240","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{"id":{"type":"string"},"attributes":{"type":"object","properties":{"uri":{"type":"string"},"title":{"type":"string"},"keyword":{"type":"null"},"description":{"type":"string"},"tags":{"type":"string"},"cover":{"type":"string"},"pv":{"type":"integer"},"content":{"type":"string"}},"required":["uri","title","keyword","description","tags","cover","pv","content"],"x-apifox-orders":["uri","title","keyword","description","tags","cover","pv","content"]}},"required":["id","attributes"],"x-apifox-orders":["id","attributes"]}}],"responseExamples":[],"requestBody":{"type":"none","parameters":[]},"description":"","tags":[],"status":"released","serverId":"","operationId":"","sourceUrl":"","ordering":6,"cases":[{"id":81441656,"type":"http","path":null,"name":"成功","responseId":190834240,"parameters":{"query":[],"path":[{"id":"uri#0","name":"uri","relatedId":"uri#0","enable":true,"isDelete":false,"value":"flutter-autocomplete-debounce","relatedName":"uri"}],"cookie":[],"header":[]},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"generateMode":"normal"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{"isDefaultUrlEncoding":1}}],"mocks":[],"customApiFields":"{}","advancedSettings":{"isDefaultUrlEncoding":1},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}},{"name":"博客路径","api":{"id":"75406113","method":"get","path":"/blog/paths","parameters":{"query":[],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834241","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"array","items":{"type":"object","properties":{"params":{"type":"object","properties":{"uri":{"type":"string"}},"required":["uri"],"x-apifox-orders":["uri"]}},"x-apifox-orders":["params"]}}}],"responseExamples":[],"requestBody":{"type":"none","parameters":[]},"description":"","tags":[],"status":"released","serverId":"","operationId":"","sourceUrl":"","ordering":12,"cases":[],"mocks":[],"customApiFields":"{}","advancedSettings":{"isDefaultUrlEncoding":1},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}}]},{"name":"腾讯 tim 接口","parentId":0,"serverId":"","description":"","preProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"postProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"identityPattern":{"httpApi":{"type":"inherit","bodyType":"","fields":[]}},"items":[{"name":"用户","parentId":15032824,"serverId":"","description":"","preProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"postProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"identityPattern":{"httpApi":{"type":"inherit","bodyType":"","fields":[]}},"items":[{"name":"导入单个帐号","api":{"id":"75406114","method":"post","path":"https://{
  {tim_server}}/v4/im_open_login_svc/account_import","parameters":{"query":[{"id":"VA6fwOfAMc","name":"sdkappid","example":"{
  {tim_sdkappid}}","required":false,"description":"","enable":true,"type":"string"},{"id":"7XXQds5SKG","name":"identifier","example":"{
  {tim_identifier}}","required":false,"description":"","enable":true,"type":"string"},{"id":"EnzbxrrpU4","name":"usersig","example":"{
  {tim_usersig}}","required":false,"description":"","enable":true,"type":"string"},{"id":"349Hx9sGPJ","name":"random","example":"{% mock 'timestamp' %}","required":false,"description":"","enable":true,"type":"string"},{"id":"JAUX2MzawK","name":"contenttype","example":"json","required":false,"description":"","enable":true,"type":"string"}],"path":[]},"auth":{},"commonParameters":{"query":[],"body":[],"cookie":[],"header":[]},"responses":[{"id":"190834242","name":"成功","code":200,"contentType":"json","jsonSchema":{"type":"object","properties":{"ActionStatus":{"type":"string"},"ErrorCode":{"type":"integer"},"ErrorInfo":{"type":"string"}},"required":["ActionStatus","ErrorCode","ErrorInfo"],"x-apifox-orders":["ActionStatus","ErrorCode","ErrorInfo"]}}],"responseExamples":[{"name":"成功示例","data":"{\n    \"ActionStatus\": \"OK\",\n    \"ErrorCode\": 0,\n    \"ErrorInfo\": \"\"\n}","responseId":190834242,"ordering":1}],"requestBody":{"type":"application/json","parameters":[],"jsonSchema":{"type":"object","properties":{"UserID":{"type":"string","mock":{"mock":"ducafecat"}},"Nick":{"type":"string","mock":{"mock":"猫哥"}},"FaceUrl":{"type":"string","mock":{"mock":"https://ducafecat.oss-cn-beijing.aliyuncs.com/ducafecat-video-flutter/avatar/00258VC3ly1gty0qztbhmj60e80e83zk02.jpg"}}},"x-apifox-orders":["UserID","Nick","FaceUrl"],"required":["UserID","Nick","FaceUrl"]},"example":"{\n    \"UserID\": \"52\",\n    \"Nick\": \"段涛\",\n    \"FaceUrl\": \"{
  {avatar_url}}\"\n}"},"description":"","tags":[],"status":"developing","serverId":"","operationId":"","sourceUrl":"","ordering":0,"cases":[{"id":81441657,"type":"http","path":null,"name":"成功","responseId":190834242,"parameters":{"query":[{"id":"skMbfmqv1H","relatedId":"VA6fwOfAMc","relatedName":"sdkappid","value":"{
  {tim_sdkappid}}","enable":true,"isDelete":false},{"id":"umLImBnSzD","relatedId":"7XXQds5SKG","relatedName":"identifier","value":"{
  {tim_identifier}}","enable":true,"isDelete":false},{"id":"1CFsX7WF5o","relatedId":"EnzbxrrpU4","relatedName":"usersig","value":"{
  {tim_usersig}}","enable":true,"isDelete":false},{"id":"ihdtVexZx1","relatedId":"349Hx9sGPJ","relatedName":"random","value":"{% mock 'timestamp' %}","enable":true,"isDelete":false},{"id":"yCvm17mpTL","relatedId":"JAUX2MzawK","relatedName":"contenttype","value":"json","enable":true,"isDelete":false}],"path":[],"cookie":[],"header":[]},"commonParameters":{"query":[],"body":[],"header":[],"cookie":[]},"requestBody":{"parameters":[],"data":"{\n    \"UserID\": \"ducafecat\",\n    \"Nick\": \"猫哥\",\n    \"FaceUrl\": \"https://ducafecat.oss-cn-beijing.aliyuncs.com/ducafecat-video-flutter/avatar/00258VC3ly1gty0qztbhmj60e80e83zk02.jpg\"\n}","generateMode":"normal"},"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"advancedSettings":{"isDefaultUrlEncoding":1}}],"mocks":[],"customApiFields":"{}","advancedSettings":{"isDefaultUrlEncoding":1},"mockScript":{},"codeSamples":[],"preProcessors":[],"postProcessors":[],"inheritPostProcessors":{},"inheritPreProcessors":{}}}]},{"name":"群组","parentId":15032824,"serverId":"","description":"","preProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"postProcessors":[{"id":"inheritProcessors","type":"inheritProcessors","data":{}}],"inheritPostProcessors":{},"inheritPreProcessors":{},"auth":{},"identityPattern":{"httpApi":{"type":"inherit","bodyType":"","fields":[]}},"items":[]}]}]}],"socketCollection":[],"docCollection":[],"schemaCollection":[],"webSocketCollection":[],"apiTestCaseCollection":[{"name":"根目录","children":[{"name":"默认分组","children":[],"items":[]}],"items":[]}],"apiTestSuiteCollection":[],"testCaseReferences":[],"environments":[],"commonScripts":[],"databaseConnections":[],"globalVariables":[{"variables":[{"name":"tim_server","value":"","description":""},{"name":"tim_sdkappid","value":"","description":""},{"name":"tim_identifier","value":"","description":""},{"name":"tim_usersig","value":"","description":""}],"id":"2593114"}],"commonParameters":{"parameters":{"body":[]},"id":436205,"projectId":2593114,"creatorId":563818,"editorId":563818,"createdAt":"2023-04-14T09:51:34.000Z","updatedAt":"2023-04-14T09:51:34.000Z","deletedAt":null},"projectSetting":{"apiStatuses":["developing","testing","released","deprecated"],"servers":[{"id":"default","name":"默认服务"}],"preProcessors":[],"postProcessors":[],"auth":{"type":"bearer","bearer":{"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMjY3IiwiaWF0IjoxNjgxMTEzMTU3LCJleHAiOjE2ODE3MTc5NTd9.QJEEGc8rTOkp9XQc4oldC89qcvwtdkhwd4CT-RNnmVk"}},"initialDisabledMockIds":[],"mockSettings":{},"gateway":[],"advancedSettings":{},"language":"zh-CN","id":"2062407","cloudMock":{"security":"free","enable":false,"tokenKey":"apifoxToken"}}}

1.2 Rest API 调用

腾讯提供了一系列的 api 接口，方便我们维护聊天业务功能，本文会对常见接口做一个介绍。

后面涉及到服务端调用问题不再重复。

用到的接口有用户、聊天群、消息推送。

1.2.1 签名介绍

即时通信 IM REST API 简介-服务端 API-文档中心-腾讯云

REST API 的 URL 格式如下：

https://xxxxxx/$ver/$servicename/$command?sdkappid=$SDKAppID&identifier=$identifier&usersig=$usersig&random=99999999&contenttype=json

其中各个参数的含义以及取值如下（参数名称及其取值均区分大小写）：

参数 含义 取值
https 请求协议 请求协议为 HTTPS，请求方式为 POST
xxxxxx 专属域名 中国：console.tim.qq.com新加坡：adminapisgp.im.qcloud.com首尔： adminapikr.im.qcloud.com法兰克福：adminapiger.im.qcloud.com孟买：adminapiind.im.qcloud.com硅谷：adminapiusa.im.qcloud.com
ver 协议版本号 固定为v4
servicename 内部服务名，不同的 servicename 对应不同的服务类型 示例：v4/im_open_login_svc/account_import，其中im_open_login_svc为servicename更多详情请参见 REST API 接口列表
command 命令字，与 servicename 组合用来标识具体的业务功能 示例：v4/im_open_login_svc/account_import，其中account_import为command更多详情请参见 REST API 接口列表
sdkappid App 在即时通信 IM 控制台获取的应用标识 在申请接入时获得
identifier 用户名，调用 REST API 时必须为 App 管理员帐号 参见 App 管理员
usersig 用户名对应的密码 参见 生成 UserSig
random 标识当前请求的随机数参数 32位无符号整数随机数，取值范围0 - 4294967295
contenttype 请求格式 固定值为json

1.2.2 腾讯接口

生成管理员 administrator 签名

登录 - 腾讯云

进入后台 辅助工具->UserSig生成&校验

配置到项目的 env 中

# tim

tim_server=console.tim.qq.com tim_appid=1400803542 tim_key=4d461a6e470248ffeeb75484xxxxxsssss7ee5b27126c5a728 tim_admin_sig=eJwtzEELgkAUxxxsssszexVNhkrV9VgTbMthZ3JxXBx8n-n7NjRVNn6-Z9weliDXv

包装一个 post 请求函数
    async _post(path, jsonValue) {
        // 随机的32位无符号整数
        const random = Math.floor(Math.random() * 4294967295)
        const url = `https://${config.tim_server}/${path}?sdkappid=${config.tim_appid}&identifier=administrator&usersig=${config.tim_admin_sig}&random=${random}&contenttype=json`
        const res = await superagent.post(url).send(jsonValue).set('accept', 'json')
        const json = JSON.parse(res.text)
        return json
    }
查询账号

即时通信 IM 查询账号-服务端 API-文档中心-腾讯云

用于查询自有帐号是否已导入即时通信 IM，支持批量查询。


    async queryUser(username) {
        const req = {
            CheckItem: [
                {
                    UserID: username
                }
            ]
        }
        const res = await this._post('v4/im_open_login_svc/account_check', req)
        if (res.ActionStatus != 'OK') {
            throw new Error(res)
        }

        return res
    }
导入单个账号

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1867195.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

发；flask的基本使用2

发；flask的基本使用2

上一篇我们介绍了基本使用方法 flask使用 【 1 】基本使用 from flask import Flask# 1 实例化得到对象 app Flask(__name__)# 2 注册路由--》写视图函数 app.route(/) def index():# 3 返回给前端字符串return hello worldif __name__ __main__:# 运行app，默认…
阅读更多...
c++11 abi 兼容性

c++11 abi 兼容性

理解 _GLIBCXX_USE_CXX11_ABI: 兼容性与现代化之间的平衡 随着 C 标准的不断演进，编译器和标准库实现也在不断更新，以支持新的语言特性和库功能。然而，这些更新有时会引入不兼容的更改，特别是应用程序二进制接口（ABI&…
阅读更多...
第N8周:seq2seq翻译实战-Pytorch复现

第N8周:seq2seq翻译实战-Pytorch复现

🍨 本文为🔗365天深度学习训练营 中的学习记录博客🍖 原作者：K同学啊 | 接辅导、项目定制 一、前期准备 from __future__ import unicode_literals, print_function, division from io import open import unicodedata import s…
阅读更多...
Jenkins通过Squid代理服务器添加局域网节点机器

Jenkins通过Squid代理服务器添加局域网节点机器

✨前言： 当jenkins在公网上的时候，如果要添加局域网内的服务器为节点机器构建的时候，这里就需要通过squid代理服务来实现了。当然你也可以使用其他的方式例如Apache等等，这里主要介绍通过Squid的方式。 🌟什么是Squi…
阅读更多...
通过颜色传感器控制机械臂抓物体

通过颜色传感器控制机械臂抓物体

目录 1 绪论 2整体设计方案 2.1 系统的介绍 2.2 抓取模块 2.2.1 机械臂的定义 2.2.2 机械臂的分类 2.2.3 机械臂的选用 2.3 颜色识别模块 2.3.1 颜色传感器识别原理 2.3.2 TCS3200简介 2.4 整体控制方案 3 颜色识别抓取系统的硬件设计 3.1 单片机选型及参数 3.2 系…
阅读更多...
第三十二篇——大数据2：大数据思维的四个层次

第三十二篇——大数据2：大数据思维的四个层次

目录 一、背景介绍二、思路&方案三、过程1.思维导图2.文章中经典的句子理解3.学习之后对于投资市场的理解4.通过这篇文章结合我知道的东西我能想到什么？ 四、总结五、升华 一、背景介绍 我们生活在这个时代，我们是否按照这个时代需要的思维方式去思…
阅读更多...
SHELL/2024/6/26

SHELL/2024/6/26

1.统计家目录下.c文件的个数 #!/bin/bash count0 for filename in $(ls ~ *.c) do ((count)) done echo count$count 2.终端输入一个.sh文件，判断文件是否具有可执行权限/然后运行脚本，没有可执行权限，添加可执行权运行脚本 #!/bi…
阅读更多...
windows USB设备驱动开发通用技术

windows USB设备驱动开发通用技术

通用串行总线 (USB) 设备通过配置、接口、备用设置和终结点来定义其功能和功能，下面提供这些概念的高级概述。 常见 USB 方案 获取用于通信的设备句柄 ，并使用检索到的句柄或对象发送数据传输。 USB 描述符检索 以获取有关设备配置的信息、接口、设置及…
阅读更多...
C语言之进程学习

C语言之进程学习

进程打开的文件列表：就是0 1 2 stdin stdout stderro等 类似于任务管理器是动态分ps是静态的 Zombie状态： 在Linux进程的状态中，僵尸进程是非常特殊的一种，它是已经结束了的进程，但是没有从进程表中删除。太多了会导…
阅读更多...
Flutter笔记（一）- 安装和配置Flutter

Flutter笔记（一）- 安装和配置Flutter

一、下载Flutter 访问网址：https://docs.flutter.dev/get-started/install?hlzh-cn 根据电脑所使用的操作系统的平台进行选择。笔者电脑的操作系统为Windows，因此选择如图1-1的Windows图片： 图1-1 Flutter网站（一） …
阅读更多...
【LangChain系列——案例分析】【基于SQL+CSV的案例分析】【持续更新中】

【LangChain系列——案例分析】【基于SQL+CSV的案例分析】【持续更新中】

目录 前言一、LangChain介绍二、在SQL问答时如何更好的提示？2-1、安装2-2、SQLite 样例数据2-3、使用langchain与其进行交互2-4、查看模型提示语2-5、提供表定义和示例行2-6、将表信息插入到Prompt中去2-7、添加自然语言->SQL示例2-8、在向量数据库中查找最相关的…
阅读更多...
springboot异常产生原因

springboot异常产生原因

DataIntegrityViolationException Cause: java.sql.SQLException: Field ‘id’ doesn’t have a default value org.springframework.dao.DataIntegrityViolationException: ### Error updating database. Cause: java.sql.SQLException: Field id doesnt have a default …
阅读更多...
qt开发-15_QFile

qt开发-15_QFile

QFile 类提供了读取和写入文件的接口。在嵌入式里如果需要读写文件，最简单的方法就是 用 Qfile。 QFile 是一个读写文本、二进制文件和资源的 I/O 设备。QFile 可以自己使用，也可以更方 便地与 QTextStream 或 QDataStream 一起使用。 文件名通常在构造函…
阅读更多...
海云安参编《数字安全蓝皮书 》正式发布并入选《2024中国数字安全新质百强》荣膺“先行者”

海云安参编《数字安全蓝皮书 》正式发布并入选《2024中国数字安全新质百强》荣膺“先行者”

近日，国内数字化产业第三方调研与咨询机构数世咨询正式发布了《2024中国数字安全新质百强》（以下简称百强报告）。海云安凭借在开发安全领域的技术创新力及市场影响力入选百强报告“新质百强先行者” 本次报告，数世咨询经过对国内8…
阅读更多...
获取个人免费版Ubuntu Pro

获取个人免费版Ubuntu Pro

首先上官网地址：Ubuntu Pro | Ubuntu 点击页面中的"Get Ubuntu Pro now" 将用途选为“Myself”，在此页面中Ubuntu说明了该版本只面向个人开发者，且最终只允许5台设备免费使用；因而部署设备的抉择就不得不慎重考虑了&am…
阅读更多...
Java | Leetcode Java题解之第200题岛屿数量

Java | Leetcode Java题解之第200题岛屿数量

题目&#xff1a; 题解&#xff1a; class Solution {void dfs(char[][] grid, int r, int c) {int nr grid.length;int nc grid[0].length;if (r < 0 || c < 0 || r > nr || c > nc || grid[r][c] 0) {return;}grid[r][c] 0;dfs(grid, r - 1, c);dfs(grid, r…
阅读更多...
设计模式原则——接口隔离原则

设计模式原则——接口隔离原则

设计模式原则 设计模式示例代码库地址&#xff1a; https://gitee.com/Jasonpupil/designPatterns 接口隔离原则 要求程序员尽量将臃肿庞大的接口拆分为更小的和更具体的接口&#xff0c;让接口中只包含客户感兴趣的方法接口隔离原则的目标是降低类或模块之间的耦合度&…
阅读更多...
WIN版-苹果和平精英画质帧率优化教程

WIN版-苹果和平精英画质帧率优化教程

一、视频教程&#xff1a; 想要视频的联系博主 二、图文教程&#xff1a; 前置说明&#xff1a;不按教程&#xff0c;会导致修改不成功&#xff0c;或者设备里面内容丢失。请务必按教程操作&#xff01;&#xff01; 准备工作&#xff08;这部分是在要改的设备上操作&#x…
阅读更多...
数据结构--栈（图文）

数据结构--栈（图文）

栈是一种基本的抽象数据类型&#xff0c;具有后进先出的特点。在栈这种数据结构中&#xff0c;元素只能在一端进行插入和删除操作&#xff0c;这一端被称为栈顶&#xff08;Top&#xff09;&#xff0c;而另一端则称为栈底&#xff08;Bottom&#xff09;。 栈的概念及特点 栈…
阅读更多...
C语言单链表的算法之插入节点

C语言单链表的算法之插入节点

一&#xff1a;访问各个节点中的数据 &#xff08;1&#xff09;访问链表中的各个节点的有效数据&#xff0c;这个访问必须注意不能使用p、p1、p2&#xff0c;而只能使用phead &#xff08;2&#xff09;只能用头指针不能用各个节点自己的指针。因为在实际当中我们保存链表的时…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023