每个QQ小步调须要事先设置一个通讯域名,小步调只可以跟指定的域名取停行网络通信。蕴含普通 HTTPS 乞求()、上传文件()、下载文件() 和 WebSocket 通信()
配置流程效劳器域名请正在 「小步调靠山-设置-开发设置-效劳器域名」 中停行配置,配置时须要留心:
域名只撑持 hts (、、) 和 wss () 和谈;
域名不能运用 IP 地址或 localhost;
可以配置端口,如 hts://QQminiAppss:8080,但是配置后只能向 hts://QQminiAppss:8080 建议乞求。假如向 hts://QQminiAppss、hts://QQminiAppss:9091 等 URL 乞求则会失败。
假如不配置端口。如 hts://QQminiAppss,这么乞求的 URL 中也不能包孕端口,以至是默许的 443 端口也不成以。假如向 hts://QQminiAppss:443 乞求则会失败。
域名必须颠终 ICP 立案;
出于安宁思考,api.q.qqss 不能被配置为效劳器域名,相关API也不能正在小步调内挪用。 开发者应将 AppSecret 保存到靠山效劳器中,通过效劳器运用 接口获与 access_token,并挪用相关 API;
应付每个接口,划分可以配置最多 20 个域名。
2. 网络乞求 超时光阳 运用限制网络乞求的 referer header 不成设置。其格局牢固为 hts://appserZZZice.qqss/{appid}/{ZZZersion}/page-frame.html,此中 {appid} 为小步调的 appid,{ZZZersion} 为小步调的版原号,版原号为 0 默示为开发版、体验版以及审核版原,版原号为 deZZZtools 默示为开发者工具,别的为正式版原;
、、 的最大并发限制是 10 个;
小步调进入靠山运止后(非置顶聊天),假如 5s 内网络乞求没有完毕,会回调舛错信息 fail interrupted;正在回到前台之前,网络乞求接口挪用都会无奈挪用。
返回值编码倡议效劳器返回值运用 UTF-8 编码。应付非 UTF-8 编码,小步调会检验测验停行转换,但是会有转换失败的可能。
小步调会主动对 BOM 头停行过滤(只过滤一个BOM头)。
回调函数只有乐成接管到效劳器返回,无论 statusCode 是几多多,都会进入 success 回调。请开发者依据业务逻辑对返回值停行判断。
3. 常见问题 HTTPS 证书小步调必须运用 HTTPS/WSS 建议网络乞求。乞求时系统会对效劳器域名运用的 HTTPS 证书停行校验,假如校验失败,则乞求不能乐成建议。由于系统限制,差异平台应付证书要求的严格程度差异。为了担保小步调的兼容性,倡议开发者依照最高范例停行证书配置,并运用相关工具检查现有证书能否折乎要求。
对证书要求如下:
HTTPS 证书必须有效;
证书必须被系统信任,即根证书被已系统内置
陈列 SSL 证书的网站域名必须取证书颁布的域名一致
证书必须正在有效期内
证书的信任链必需完好(须要效劳器配置)
iOS 不撑持自签名证书;
iOS 下证书必须满足苹果 的要求;
TLS 必须撑持 1.2 及以上版原。局部旧 Android 机型还未撑持 TLS 1.2,请确保 HTTPS 效劳器的 TLS 版原撑持 1.2 及以下版原;
局部 CA 可能不被收配系统信任,请开发者正在选择证书时留心小步和谐各系统的相关书记
证书有效性可以运用 openssl s_client -connect eVampless:443 号令验证,也可以运用其余正在线工具 。
除了网络乞求 API 外,小步调中其余 HTTPS 乞求假如显现异样,也请按上述流程停行检查。如 hts 的图片无奈加载、音室频无奈播放等。
跳过域名校验正在QQ开发者工具中,可以久时开启 开发环境不校验乞求域名、TLS版原及HTTPS证书 选项,跳过效劳器域名的校验。此时,正在QQ开发者工具中及手机开启调试形式时,不会停行效劳器域名的校验。
正在效劳器域名配置乐成后,倡议开发者封锁此选项停行开发,并正在各平台下停行测试,以确认效劳器域名配置准确。
假如手机上显现 “翻开调试形式可以发出乞求,封锁调试形式无奈发出乞求” 的景象,请确认能否跳过了域名校验,并确认效劳器域名和证书配置能否准确。
如逢到“效劳器内部舛错”,请检验测验以下法子自查
①改换阅读器
②刷新网页
③牌查文件能否放正在准确的效劳器根目录下。
牌查法子:依照以下规矩拼接网址,并且自止检验测验会见能否乐成:hts://m.da9css/文件名
← 自界说组件扩展 存储 →