工具与资源
快捷入口(移动端)
Ⅰ 顶部导航加号菜单图标 <div style="margin:25px 0px"> <img src="build-in/assets/media/Icon2-1.svg" alt="单文章消息" width="212px" height="39px" /> </div>
外观:此类图标以实心(Solid)样式为主,特殊情况时也可使用线条样式的图标
用色:<img src="build-in/assets/media/Color2.svg" alt="单文章消息" width="86px" height="19px" />
尺寸:统一绘制在69*69px画布内(3x),圆角不要大于6px。(如需使用线条,请保持宽度为4px) ; 因菜单为左对齐,图标设计时候应略偏左2px,红色边框为图标设计区域的SAFEZONE,请保持在此区域内进行设计。设计时请参照现有的图标,保证体量上相等。
<div style="margin:25px 0px"> <img src="build-in/assets/media/Icon2-2.svg" alt="单文章消息" width="423px" height="87px" /> </div>
Ⅰ 聊天加号面板图标
<div style="margin:25px 0px"> <img src="build-in/assets/media/Icon3-1.svg" alt="单文章消息" width="186px" height="28px" /> </div>
外观:此类图标以实心(Solid)样式为主,特殊情况时也可使用线条样式的图标。
用色:<img src="build-in/assets/media/Color3.svg" alt="单文章消息" width="89px" height="20px" />
尺寸:统一绘制在90*90px画布内(3x),圆角不要大于6px。; 红色边框为图标设计区域的SAFEZONE,请保持在此区域内进行设计,区域距图标外框有6px留白。设计时请参照现有的图标,保证体量上相等。
<div style="margin:25px 0px"> <img src="build-in/assets/media/Icon3-2.svg" alt="单文章消息" width="507px" height="108px" /> </div>
Ⅰ 个人中心菜单图标
<div style="margin:25px 0px"> <img src="build-in/assets/media/Icon4-1.svg" alt="单文章消息" width="195px" height="20px" /> </div>
外观:此类图标以线条(Line)样式为主。
用色:<img src="build-in/assets/media/Color4.svg" alt="单文章消息" width="90px" height="20px" />
尺寸:统一绘制在60*60px画布内(3x),线条宽度3px,圆角不要大于4px。; 红色边框为图标设计区域的SAFEZONE,请保持在此区域内进行设计,区域距图标外框有3px留白。设计时请参照现有的图标,保证体量上相等。
<div style="margin:25px 0px"> <img src="build-in/assets/media/Icon4-2.svg" alt="单文章消息" width="387px" height="78px" /> </div>
工作台入口
<div style="margin:25px 0px"> <img src="build-in/assets/media/Icon6-1.svg" alt="单文章消息" width="436px" height="46px" /> </div>
外观:工作台图标保持正方形输出,设计简洁、有辨识度,尽量与蓝信官方应用风格保持一致为佳。
用色:建议使用简单的色彩搭配,图标内元素使用白色,背景使用单一色,具体请参考我们以下的推荐色。 应尽量避免使用高饱和度的配色、灰度或纯黑白的配色。
<div style="margin:25px 0px"> <img src="build-in/assets/media/Color6.svg" alt="单文章消息" width="606px" height="130px" /> </div>
尺寸:统一绘制在512*512px画布内,圆角为34px。; 红色边框为图标设计区域的SAFEZONE,尺寸为300px,请保持在此区域内进行设计。设计时请参照现有的图标,保证体量上相等。
<div style="margin:25px 0px"> <img src="build-in/assets/media/Icon6-2.svg" alt="单文章消息" width="606px" height="157px" /> </div>
图标设计要点:
- 图标应保持简洁明了,避免过多修饰,避免过于复杂,避免直接使用照片。
- 请保证图标中的线条不要过于纤细,以免在手机上影响图标辨识度。
- 图标中尽量避免直接放置文字,如必须使用应避免使用过细字体或两个以上的汉字。
- 尽量避免使用角标,如必须使用也需控制角标的尺寸不超过图标宽度的50%,避免遮挡主体。
要点示意:使用单一的主体图形,图形需清晰无变形,避免复杂的结构及装饰,避免直接使用照片作为图标。
<div style="margin:25px 0px"> <img src="build-in/assets/media/Icon6-3.svg" alt="单文章消息" width="636px" height="83px" /> </div>
服务端接口Postman测试模版使用指南
简介
蓝信开放平台服务端接口测试工具由Postman开发工具模版实现。模版有两部分组成:1. 接口测试模版,包含了开发者文档中所有服务端接口的测试模版。2. 环境变量模版,提供接口测试模版所使用的部分公共变量的定义,例如:开放平台接口的访问地址,appid,secret, app_token等。
离线模版下载地址
蓝信开放平台服务端接口测试工具Postman开发工具模版的下载地址: <a href="/build-in/server-api/tools/media/lanxin-api-template.rar" download="lanxin-api-template.rar">蓝信开放平台服务端接口Postman测试模版</a>,下载后解压到本地。
在线模板库使用说明
-
通过点击按钮
,后在跳转到的页面点击Fork Collection,并使用已有账号进行登录。选择其中一个workspace,点击Fork Collection,即可在Workspace中调试蓝信api模板库与使用对应的环境变量。
请点击Fork Collection。 <div> <img src="build-in/server-api/tools/media/RunInPostman-1.png" alt="Fork Collection" width="90%" height="90%" /> </div>
选择一个Workspace进行Fork。 <div> <img src="build-in/server-api/tools/media/RunInPostman-2.png" alt="Fork Collection into workspace" width="90%" height="90%" /> </div>
等待一段时间后(时间可能较长)即可在线调试collection。 <div> <img src="build-in/server-api/tools/media/RunInPostman-3.png" alt="collection" width="90%" height="90%" /> </div>
-
获取Postman模板更新。通过点击lanxin-openapi右侧 ”...“ 下拉菜单中的merge changes更新最新版本的模板库。当存在模板库更新时,即可点击页面上方出现的提示横幅中pull changes 查看详情。在详情页面中pull changes应用更改。 <div> <img src="build-in/server-api/tools/media/RunInPostman-4.png" alt="open merge changes" width="30%" height="90%" /> <img src="build-in/server-api/tools/media/RunInPostman-5.png" alt="merge changes" width="60%" height="90%" /> </div>
-
Watch 更新。访问蓝信开放平台workspace 点击 watch 关注更新,当API模板发生更改时会通知您,即可通过merge changes 拉取更新。 <div> <img src="build-in/server-api/tools/media/RunInPostman-6.png" alt="watch" width="90%" height="90%" /> </div>
离线模版库安装使用说明
测试模版使用简要说明
- 下载Postman测试工具并安装(目前(2021/8)windows平台最新版本Postman的版本为v8.11.1)。
- 下载蓝信服务端接口测试模版。
- 在Postman中创建一个新的personal workspace。
- 打开新创建的workspace,然后分别导入两个蓝信服务端接口测试模版。
- 环境变量模版中设置从蓝信开放平台开发者中心获取的应用相关接入参数:开放平台网关地址,授权页地址,appid,secret。
- 通过接口测试模版中第一个接口 “获取应用访问TOKEN” 获取应用访问token并设置到环境变量测试模版中。
- 开始其他接口测试。特别说明:其他接口测试时,接口内容参数需要根据实际测试环境进行正确赋值,参数中部分ID相关的数据来源参考接口文档中的说明。
测试模版使用详细说明
- 下载Postman(下载地址:https://www.postman.com/ )并安装。以下示例使用Postman版本为 windows平台的 v8.11.1。
- 下载蓝信服务端接口测试Postman测试模版 (<a href="/build-in/server-api/tools/media/lanxin-api-template.rar" download="lanxin-api-template.rar">蓝信开放平台服务端接口Postman测试模版</a>)。
- 打开Postman,创建一个新的workspace:
<div> <img src="build-in/server-api/tools/media/1_1.png" alt="create workspace 1" width="90%" height="90%" /> <img src="build-in/server-api/tools/media/1_2.png" alt="create workspace 2" width="90%" height="90%" /> <img src="build-in/server-api/tools/media/1_3.png" alt="import template 3" width="90%" height="90%" /> <img src="build-in/server-api/tools/media/1_4.png" alt="import template 4" width="90%" height="90%" /> <img src="build-in/server-api/tools/media/1_5.png" alt="import template 5" width="90%" height="90%" /> </div>
- 设置环境变量的值,首先设置开放平台网关地址,授权页地址,appid,secret四个信息,这些信息可以在你的测试环境的蓝信开发者中心的应用详情页获取。
<div> <img src="build-in/server-api/tools/media/2_1.png" alt="config environment 1" width="90%" height="90%" /> <img src="build-in/server-api/tools/media/2_2.png" alt="config environment 2" width="90%" height="90%" /> </div>
- 环境变量设置完成后,首先要获取应用访问token,并将这个app_token也设置到环境变量中:
<div> <img src="build-in/server-api/tools/media/3_1.png" alt="config apptoken 1" width="90%" height="90%" /> <img src="build-in/server-api/tools/media/3_2.png" alt="config apptoken 2" width="90%" height="90%" /> </div>
- 设置完以上信息后可以尝试其他接口的测试了。特别说明:接口测试时,接口内容参数需要根据实际测试环境进行正确赋值,参数中部分ID相关的数据来源参考接口文档中的说明。
<div> <img src="build-in/server-api/tools/media/4_1.png" alt="api test" width="90%" height="90%" /> </div>
从github获取蓝信服务端接口SDK
蓝信开放平台提供Java,Python,PHP,Golang 等语言的服务端接口SDK,请通过蓝信的github主页获取SDK代码和相关的使用说明。