蓝信用户如何变更手机号变更通知短信?
点击联系发帖人
时间：2018-07-04 08:45
蓝信开放平台是提供给第三方应用为蓝信用户提供服务的平台，开放接口则是为第三方应用提供服务的基础。第三方应用开发者在蓝信平台申请公众号，获取接口权限后，可以通过阅读本接口文档来帮助开发。
蓝信开放平台接口提供第三方应用与用户进行信息交互、自定义菜单交互的能力。企业可以通过这些接口整合企业应用系统到蓝信，利用蓝信通讯录和即时消息基础功能，可以实现类似微信服务号/订阅号的应用。
蓝信开放平台提供自定义菜单接口，自定义菜单能够帮助公众号丰富界面，让用户更好更快地理解公众号的功能。公众号界面如图所示：
目前自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字，二级菜单最多7个汉字，多出来的部分将会以“...”代替。请注意，创建自定义菜单后，由于蓝信客户端缓存，需要24小时蓝信客户端才会展现出来。
说明：由于客户端会缓存菜单，建议开发时，如果更新了菜单，可以手动删除消息会话列表中的公众号，然后重新推送客服消息，就可以看到更新后的菜单。android客户端也可以清除应用缓存更新客户端菜单显示。
第一步：申请蓝信公众号
联系蓝信平台组织管理员，开通一个蓝信公众号。
第二步：获取token、appid和开发者密钥secret
token用作生成签名，第三方接收开放平台数据时会收到token的签名，通过和本地token比较，验证请求安全性。
appid指开放平台分配给第三方的开发者账号。
secret指开放平台分配给第三方的开发者密钥。
公众号开通后，通过蓝信或者Email将公众号、企业信息、接收消息url（开放平台会将发往开发者的蓝消息推送至该url）信息提交至蓝信开放平台，蓝信开放平台生成开发者需要的token、appid和secret。同样通过蓝信或者Email发送至申请者。
第三步：成为开发者
拿到token、appid和secret后，恭喜您已经成为蓝信开放平台开发者，蓝信开放平台提供了可视化测试工具，访问地址为http://ip:端口/debug，开发者动手开发前可以通过该测试工具体验获取access_token、上传/下载资源文件、发送客服消息、查询菜单等接口。同时，也能进一步理解各个接口的作用。
蓝信开放平台支持http和https，开发者使用接口前，需要用appid和secret换取access_token，access_token是蓝信开放平台的全局唯一凭据，调用各个接口时都需要使用access_token
access_token是动态的、且有时效性，有效时间为7200s。
消息分为客服消息和被动响应消息。
客服消息：公众号主动向用户发送消息。
被动响应消息：用户向公众号发送消息或者菜单事件，公众号作出响应的消息。
1. 客服消息的消息体采用json格式
参数说明：
资源文件ID，附件消息使用
消息中链接，图文和链接消息使用
示例数据：
"touser": "OPENID",
"msgtype": "attachment",
"attachment": {
"media_id": "MEDIA_ID"
被动响应消息的消息体采用xml格式
参数说明：
ToUserName
资源文件ID，附件消息使用
消息中链接，图文和链接消息使用
CreateTime
消息创建时间
示例数据：
&ToUserName&&![CDATA[接收者]]&&/ToUserName&
&FromUserName&&![CDATA[发送者]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[text]]&&/MsgType&
&Content&&![CDATA[你好]]&&/Content&
公众号每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。
全局返回码说明如下：
数据请求失败
不支持公号对公号发送
菜单已存在，请勿重复创建
没有找到对应菜单
无权请求此组织数据
找不到此消息对应的附件，请您检查后重新发送
消息发送失败
获取access_token时AppSecret错误，或者access_token无效
不合法的凭证类型
不合法的文件大小
不合法的媒体文件id
不合法的消息类型
不合法的APPID
不合法的access_token
不合法的菜单类型
不合法的按钮个数
不合法的按钮个数
不合法的按钮名字长度
不合法的按钮KEY长度
不合法的按钮URL长度
不合法的子菜单级数
不合法的子菜单按钮个数
不合法的子菜单按钮类型
不合法的子菜单按钮名字长度
不合法的子菜单按钮KEY长度
不合法的子菜单按钮URL长度
不合法的自定义菜单使用用户
不合法的oauth_code
不合法的refresh_token
不合法的请求字符，不能包含\uxxxx格式的字符
不合法的参数
不合法的请求格式
不合法的URL长度
缺少access_token参数
缺少appid参数
缺少refresh_token参数
缺少secret参数
缺少多媒体文件数据
缺少media_id参数
缺少子菜单数据
缺少oauth code
access_token超时
refresh_token超时
oauth_code超时
需要GET请求
需要POST请求
需要HTTPS请求
多媒体文件为空
POST的数据包为空
图文消息内容为空
文本消息内容为空
消息内容超过限制
标题字段超过限制
描述字段超过限制
链接字段超过限制
图片链接字段超过限制
图文消息超过限制
创建菜单个数超过限制
回复时间超过限制
不存在媒体数据
不存在的菜单版本
不存在的菜单数据
不存在的用户
解析JSON/XML内容错误
api功能未授权
用户未授权该api
auth_token无效
用户认证，sso_token不能为空！
sso_token错误，认证失败！
第三方可从msgcontent获取开放平台推送的消息内容。
开发者接收消息的时候，开放平台将发送POST请求到开发者填写的URL上，并且带了四个参数（singature、timestamp、nonce、echostr），开发者通过对签名（即singature）的校验，来判断消息的真实性。
加密协议：
蓝信加密签名，signature为开发者填写的token和请求中的timestamp、nonce、echostr参数加密的结果
随机字符串
加密/校验流程如下：
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比，结果一样表示该请求来源于蓝信。
当蓝信用户向公众账号发消息时，开放平台将消息POST到开发者填写的URL上。关于重试的消息排重，推荐使用msgid排重
注意：假如开发者服务器无法保证在五秒内处理并回复，可以直接回复空串，开放平台不会对此作出任何处理，并且不会发起重试。
各消息类型协议和数据如下：
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
消息类型text
文本消息内容
示例数据：
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[fromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[text]]&&/MsgType&
&Content&&![CDATA[this is a test]]&&/Content&
&MsgId&3456&/MsgId&
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
attachment
图片消息媒体id，可以调用多媒体文件下载接口拉取数据
示例数据：
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[fromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[attachment]]&&/MsgType&
&MediaId&&![CDATA[mediaId]]&&/MediaId&
&MsgId&3456&/MsgId&
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
链接地址URL
示例数据：
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[fromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[link]]&&/MsgType&
&Url&&![CDATA[url]]&&/Url&
&MsgId&3456&/MsgId&
菜单事件包括CLICK、VIEW、LOCATION、PROXYVIEW，其中CLICK、LOCATION；类型事件会被转发到第三方，第三方可从msgContent获取消息内容，由第三方处理返回响应数据。
开放平台在十秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次 关于重试的消息排重，推荐使用FromUserName + CreateTime 排重。
假如开发者服务器无法保证在十秒内处理并回复，可以直接回复空串，开放平台不会对此作任何处理，并且不会发起重试。
用户点击自定义菜单后，如果菜单按钮设置为click类型，则会把此次点击事件推送给开发者，注意view类型菜单点击，是跳转到url，不会推送事件消息到公众号。
各个事件消息协议和数据如下：
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
消息类型：event表示事件消息类型
事件类型：CLICK菜单事件，将菜单key发送只开发者
菜单KEY，开发者可以通过KEY区分不同业务
示例数据：
&MsgId&-1111&/MsgId&
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[FromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[event]]&&/MsgType&
&Event&&![CDATA[CLICK]]&&/Event&
&EventKey&&![CDATA[EVENTKEY]]&&/EventKey&
创建菜单事件类型为location时，客户端会上报当前地理位置信息。
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
消息类型：event表示事件消息类型
事件类型：CLICK
Location_X
地理位置纬度
Location_Y
地理位置经度
地图缩放大小
地理位置信息
示例数据：
&MsgId&-1111&/MsgId&
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[FromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[event]]&&/MsgType&
&Event&&![CDATA[CLICK]]&&/Event&
&Location_X&23.134521&/Location_X&
&Location_Y&113.358803&/Location_Y&
&Scale&20&/Scale&
&Label&&![CDATA[位置信息]]&&/Label&
手机客户端通过公众平台向公号发送消息或者菜单事件，公众平台将消息或者菜单事件转发到第三方的redirect_url，第三方返回给公众平台响应消息（若无响应消息，返回空）。
各消息类型协议和数据如下：
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：text
文本消息内容
示例数据：
&FromUserName&公号&/FromUserName&
&ToUserName&&![CDATA[手机号]]&&/ToUserName&
&CreateTime&时间戳&/CreateTime&
&MsgType&&![CDATA[text]]&&/MsgType&
&Content&&![CDATA[你好]]&&/Content&
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：attachment
附件资源ID，上传附件，由开放平台产生
示例数据：
&FromUserName&公号&/FromUserName&
&ToUserName&&![CDATA[手机号]]&&/ToUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[attachment]]&&/MsgType&
&MediaId&&![CDATA[1]]&&/MediaId&
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：link
示例数据：
&FromUserName&公号&/FromUserName&
&ToUserName&&![CDATA[手机号]]&&/ToUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[link]]&&/MsgType&
&Url&&![CDATA[http://www.baidu.com]]&&/Url&
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：news
图文消息标题
ArticleCount
图文消息个数，限制为10条以内
多条图文消息信息，默认第一个item为大图,注意，如果图文数超过10，则将会无响应
Description
图文消息描述
图片链接，支持JPG、PNG格式，较好的效果为大图360*200，小图200*200
点击图文消息跳转链接
示例数据：
&ToUserName&&![CDATA[toUser]]&&/ToUserName&
&FromUserName&&![CDATA[fromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[news]]&&/MsgType&
&ArticleCount&2&/ArticleCount&
&Articles&
&Title&&![CDATA[title1]]&&/Title&
&Description&&![CDATA[description1]]&&/Description&
&PicUrl&&![CDATA[picurl]]&&/PicUrl&
&Url&&![CDATA[url]]&&/Url&
&Title&&![CDATA[title]]&&/Title&
&Description&&![CDATA[description]]&&/Description&
&PicUrl&&![CDATA[picurl]]&&/PicUrl&
&Url&&![CDATA[url]]&&/Url&
&/Articles&
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：backGround，view
客户端需要跳转的url
说明：MsgType取值backGround客户端从后台请求Url，取值view则客户端通过webview打开。
示例数据：
&FromUserName&公号&/FromUserName&
&ToUserName&&![CDATA[手机号]]&&/ToUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[backGround/view]]&&/MsgType&
&Url&&![CDATA[http://ip:端口/xxx]]&&/Url&
使用接口时，采用POST方式传参
http://ip:端口/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
接口描述：
access_token是公众号的全局唯一凭据，公众号调用各接口时，都需要使用access_token。
http请求方式：POST/GET
request参数对象：
grant_type
获取access_token填写client_credential
第三方用户唯一凭证
开发者密钥
参数对象：
access_token
获取到的凭证
expires_in
凭证有效时间，单位：秒
返回数据示例：
成功返回：
"errcode": 0,
"access_token": "ACCESS_TOKEN",
"expires_in": 7200
错误返回：
"errcode": 40013,
"errmsg": "不合法的APPID "
http://ip:端口/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
接口描述：
上传资源文件，文件类型包括：音/视频、图片、office文件等，用于发送附件消息、图文消息。
http请求方式：POST
request参数对象：
access_token
调用接口凭证
媒体文件类型：分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb）
form-data中媒体文件标识，有filename，filelength，content-type等信息
response参数对象：
请求状态码
资源文件ID
返回数据示例：
成功返回：
"errcode": 0,
"type": "TYPE",
"media_id": "MEDIA_ID",
"created_at":
错误返回：
"errcode": 40004,
"errmsg": "不合法的媒体文件类型"
http://ip:端口/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
下载文件。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
媒体文件ID
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回数据示例：
成功返回http头如下：
HTTP/1.1 200 OK
Connection: close
Content-Type: image/jpeg
Content-disposition: filename="MEDIA_ID.jpg"
Date: Sun, 06 Jan :18 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 339721
curl -G "http://ip：端口/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"
错误返回：
"errcode": 40007,
"errmsg": "不合法的媒体文件id"
注意：此接口可以用于获取用户头像
http://ip:端口/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
接口描述：
发送客服消息指公众号向手机客户端发送消息。支持发送文本、附件、链接、图文、邮件消息
http请求方式：POST，POST一个JSON数据包来发送消息
request参数对象：
access_token
调用接口凭证
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
返回数据示例：
成功返回：
"errcode": 0,
"errmsg": "请求成功"
错误返回：
"errcode": 40014,
"errmsg": "不合法的access_token "
消息体说明如下：
消息体对象：
接收方帐号
消息类型：text
文本消息内容
"touser": "手机号",
"msgtype": "text",
"content": "Hello World"
支持图片、音频、视频、office文件等附件消息。
消息体对象：
接收方帐号
消息类型：attachment
附件资源文件ID
"touser": "OPENID",
"msgtype": "attachment",
"title":"标题"
"attachment": {
"media_id": "MEDIA_ID"
消息体对象：
接收方帐号
消息类型：link
"touser": "OPENID",
"msgtype": "link",
"url": "http://www.lanxin.cn"
图文消息条数限制在10条以内，注意，如果图文数超过10，则将会无响应。
消息体对象：
接收方帐号
消息类型：news
description
点击后跳转的链接
图文消息的图片链接
图文消息链接类型，默认值为0：0 URL；1 语音； 2 视频； 3 文档 ； 4 未知
int类型：0 默认值，可以不传；1. 访问link的时候增加name和telephone要求以_ckey为可以传递。例如：http://host/path/uri?_ckey=base64(name=name&telephone=telephon)
"touser": "手机号",
"msgtype": "news",
"articles": [{
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"picurl": "PIC_URL",
"type": 0,
"flag": 0},
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"picurl": "PIC_URL",
"type": 0,
"flag": 0}]
邮件消息是一种特殊的图文消息。
消息体对象：
接收方帐号
消息类型：mail
邮件消息链接地址
邮件消息标题
"touser": "OPENID",
"msgtype": "mail",
"url": "http://www.lanxin.cn",
"title": "邮件标题"
重要说明：
1) 邮件消息url返回数据对象：
有无附件标识，0-无附件；1-有附件
邮件打开链接
新邮件文本内容
发送者邮箱
邮件发送时间
2) 示例数据：
"flag": 0,
"link": "http://ip:端口/lanxin_opc_360cloud/videoTest.jsp",
"mainText”:”新邮件文本内容",
"mailFrom": "",
"time": "14-05-23 15:30",
"title": "邮件标题"
http://ip:端口/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN
接口描述：
群发消息指第三方向多人或者多组织（分支部门）的成员发送消息。
http请求方式：POST，POST一个JSON数据包来发送消息
request参数对象：
access_token
调用接口凭证
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
返回数据示例：
成功返回：
"errcode": 0,
"errmsg": "请求成功"
错误返回：
"errcode": 40014,
"errmsg": "不合法的access_token "
消息体说明如下：
消息体对象：
多个接收方手机号，多个以“,”间隔
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：text
文本消息内容
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "text",
"content": "Hello World"
支持图片、音频、视频、office文件等附件消息。
消息体对象：
多个接收方手机号，多个以“,”间隔
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：attachment
附件资源文件ID
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "attachment",
"title":"标题",
"attachment": {
"media_id": "MEDIA_ID"
消息体对象：
多个接收方手机号，多个以“,”间隔
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：link
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "link",
"url": "http://www.lanxin.cn"
图文消息条数限制在10条以内，注意，如果图文数超过10，则将会无响应。
消息体对象：
多个接收方手机号，多个以“,”间隔，tousers和togroups二者至少有一个
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：news
description
点击后跳转的链接
图文消息的图片链接
图文消息链接类型，默认值为0：0 URL；1 语音； 2 视频； 3 文档 ； 4 未知
int类型：0 默认值，可以不传；1. 访问link的时候增加name和telephone要求以_ckey为可以传递。例如：http://host/path/uri?_ckey=base64(name=name&telephone=telephon)
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "news",
"articles": [
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"picurl": "PIC_URL",
"type": 0,
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"picurl": "PIC_URL",
"type": 0,
邮件消息是一种特殊的图文消息。
消息体对象：
多个接收方手机号，多个以“,”间隔
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：mail
邮件消息链接地址
邮件消息标题
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "mail",
"url": "http://www.lanxin.cn",
"title": "邮件标题"
重要说明：
1) 邮件消息url返回数据对象：
有无附件标识，0-无附件；1-有附件
邮件打开链接
新邮件文本内容
发送者邮箱
邮件发送时间
2) 示例数据：
"flag": 0,
"link": "http://ip:端口/lanxin_opc_360cloud/videoTest.jsp",
"mainText”:”新邮件文本内容",
"mailFrom": "",
"time": "14-05-23 15:30",
"title": "邮件标题"
http://ip:端口/cgi-bin/member/get?access_token=ACCESS_TOKEN&orgId=ORGID&mobile=MOBILE&email=EMAIL
接口描述：
查询成员信息，此接口缓存时间为5分钟，非实时数据
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
待查询成员手机号
待查询成员email
注：mobile和email填写一个即可，优先取mobile进行查询
response参数对象(当返回的数据中某个字段的值为null时，该key-value在报文中不显示)：
返回状态描述
成员在组织中的位置(code路径)
用户标识符
成员所在公司名称，对应蓝信中的“单位”，一般和orgName一样。如果为集团公司，company一般为集团子公司名称
photoResId
头像资源ID（头像不存在时报文中无此字段）
所属单位ID
成员所在组织名称，一般和company一样。如果是集团公司，orgName为集团名称
secondPosition
业务属性列表
职务属性列表
contactExs
联系方式扩展
serialNumber
序列号，如警号
备注，说明
成员在组织中的位置
orgName、company、path关系说明：
如上图所示：
orgName: 集团名称。
company：集团下子公司名称
path：张三在组织机构中的位置path为orgName-company1-研发中心
非集团公司
如上图所示：
orgName和company一样，都表示公司的名称。
path：张三在组织机构中的位置path为orgName/company-技术开发部-张三。
返回数据示例：
"errcode": 0,
"errmsg": "请求成功",
"openOrgMemberList": [
mobile: "",
orgId: 34,
userUniId:"83191@34.uni1",
company:"蓝信工厂",
photoResId:"fe7cf9a1-e5b4-d72c05e24d",
parentId: 111111,
email: "",
companyId:594771,
orgName: "蓝信工场",
secondPosition: "",
contactExs:
position:"",
serialNumber:"",
name: "杨雪",
code : "34-594771",
"path": "蓝信工场-研发部",
mobile: "",
orgId: 34,
userUniId:"83191@34.uni1",
company:"蓝信工厂",
photoResId:"fe7cf9a1-e5b4-d72c05e24d",
parentId: 111111,
email: "",
companyId:594771,
orgName: "蓝信工场",
secondPosition: "",
contactExs:
position:"",
serialNumber:"",
name: "杨雪",
code : "34-594772",
path: "蓝信工场-产品部",
http://ip:端口/cgi-bin/org/struct/parent/get?access_token=ACCESS_TOKEN&orgId=ORGID&structId=STRUCTID&queryType=QUERYTYPE
接口描述：
根据组织和分支ID查询分支下的数据,可用于展示组织结构和人员信息。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
分支ID，为0时表示从根节点查询
0:分支节点;1:成员节点;-1:全部节点
response参数对象(当返回的数据中某个字段的值为null时，该key-value在报文中不显示)：
返回状态描述
openOrgStructList
分支机构列表
分支所在位置
分支父级机构，为0时，表示当前节点为根节点
openOrgMemberList
成员所在组织位置
成员所在组织名称
成员所在组织id
成员所在公司
成员在组织中的位置(code路径)
返回数据示例：
"openOrgStructList": [
"name": "北京分公司",
"path": "蓝信工场-一级分支-二级分支-北京分公司",
"code" : "34-792-594743",
"parentId": 5
"name": "上海分公司",
"path": "蓝信工场-一级分支-二级分支-上海分公司",
"code" : "34-792-594749",
"parentId": 5
"openOrgMemberList": [
"id": 1113,
"name": "杨雪",
"userUniId":"87284@34.uni1",
photoResId:"fe7cf9a1-e5b4-d72c05e24d",
"email": "",
"mobile": "",
"path": "蓝信工场-一级分支-二级分支",
"code" : "34-792-594743",
"orgName": "蓝信工场",
"orgId": 1,
"company": "蓝信工场"
"id": 1104,
"name": "杨冰",
"userUniId":"87285@34.uni1",
photoResId:"4t64cf9a1-e5b4-d72c0534e1",
"email": "",
"mobile": "",
"path": "蓝信工场-一级分支-二级分支",
"code" : "34-792-594743",
"orgName": "蓝信工场",
"orgId": 1,
"company": "蓝信工场"
"errmsg": "请求成功",
"errcode": 0
http://ip:端口/cgi-bin/message/control?access_token=ACCESS_TOKEN&msgId=MSGID
接口描述：
查询消息送达状态，支持客服消息、群发消息的状态查询。
注：要记录消息送达状态数据量会很大，默认状态下是不保存发送状态的。如果想要记录消息发送状态，需在发送的消息报文体中加入needSendingState字段
"touser": "手机号",
"msgtype": "text",
"needSendingState": 1,
"content": "Hello World"
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "text",
"needSendingState": 1,
"content": "Hello World"
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
待查询消息ID
response参数对象：
返回状态描述
sendingState
userMessageId
recieveTime
userMessageBodyId
返回数据示例：
"msgSendStateList":[{
"sendingState":0,
"mobile":"",
"dialogId":"100909",
"sendTime":0,
"userMessageId":234845,
"recieveTime":0,
"userMessageBodyId":136277,
"readTime":0
"errmsg":"请求成功",
"errcode":0
"msgSendStateList":[
"dialogId":"100909",
"sendingState":0,
"sendTime":0,
"userMessageId":232211,
"mobile":"",
"recieveTime":0,
"readTime":0,
"userMessageBodyId":134908
"dialogId":"100909",
"sendingState":0,
"sendTime":0,
"userMessageId":232212,
"mobile":"",
"recieveTime":0,
"readTime":0,
"userMessageBodyId":134908
"errmsg":"请求成功",
"errcode":0
http://ip:端口/cgi-bin/menu/create?access_token=ACCESS_TOKEN
接口描述：
创建自定义菜单。
http请求方式：POST，POST一个JSON数据包
request参数对象：
access_token
调用接口凭证
菜单参数说明：
一级菜单数组，个数应为1~3个
sub_button
二级菜单数组，个数应为1~5个
菜单的响应动作类型，目前有click、view、location、proxyView四种类型
菜单标题，不超过16个字节，子菜单不超过40个字节
菜单KEY值，用于消息接口推送，不超过128字节
1 oauth菜单view类型使用，0或者不传普通view类型
网页链接，用户点击菜单可打开链接，不超过256字节
示例数据：
"button": [
"type": "click",
"name": "今日歌曲",
"key": "V1001_TODAY_MUSIC"
"type": "click",
"name": "歌手简介",
"key": "V1001_TODAY_SINGER"
"type": "click",
"name": "签到",
"key": "qiandaokey"
"name": "菜单",
"sub_button": [
"type": "view",
"name": "搜索",
"url": "https://www.soso.com/"，
"type": "view",
"name": "视频",
"url": "https://v.lanxin.com/"
"type": "click",
"name": "赞一下我们",
"key": "V1001_GOOD"
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
返回数据示例：
a) 成功返回：
"errcode": 0,
"errmsg": "请求成功"
b) 错误返回：
"errcode": 40018,
"errmsg": "不合法的按钮名字长度"
http://ip:端口/cgi-bin/menu/get?access_token=ACCESS_TOKEN
接口描述：
查询菜单。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
response参数对象：
菜单数据列表
一级菜单数组，个数应为1~3个
sub_button
二级菜单数组，个数应为1~5个
菜单的响应动作类型，目前有click、view、location、proxyView四种类型
菜单标题，不超过16个字节，子菜单不超过40个字节
菜单KEY值，用于消息接口推送，不超过128字节
网页链接，用户点击菜单可打开链接，不超过256字节
返回数据示例：
"errcode": 0,
"errmsg": "请求成功",
"button": [
"type": "click",
"name": "今日歌曲",
"key": "V1001_TODAY_MUSIC",
"sub_button": []
"type": "click",
"name": "歌手简介",
"key": "V1001_TODAY_SINGER",
"sub_button": []
"name": "菜单",
"sub_button": [
"type": "view",
"name": "搜索",
"url": "https://www.soso.com/",
"sub_button": []
"type": "view",
"name": "视频",
"url": "https://v.lanxin.com/",
"sub_button": []
"type": "click",
"name": "赞一下我们",
"key": "V1001_GOOD",
"sub_button": []
http://ip:端口/cgi-bin/menu/delete?access_token=ACCESS_TOKEN
接口描述：
删除菜单。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
返回数据示例：
"errcode": 0,
"errmsg": "请求成功"
http://ip:端口/cgi-bin/user/ssoauth?access_token=ACCESS_TOKEN
接口描述：
通过认证令牌验证用户，返回用户的登录名（手机号码）。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
ssotoken对应的用户登录名（手机号码）
返回数据示例：
"errcode": 0,
"errmsg": "请求成功",
"mobile": ""
接口描述：
通过手机号获取该手机号对应的联系人信息（信息包括：name，userid，useruniid，company，path 五个字段）
Http请求方式: GET
http://ip:端口/lop-client/orgMember?access_token=ACCESS_TOKEN&mobile=MOBILE
http://oft05-open.e.lanxin.cn/cgi-bin/orgMember?access_token=f58b045feffb90ad0f098e3e2deb0feaa&mobile=
参数说明：
access_token
令牌，根据appid和secret获取
response参数对象：
comanyView
departmentView
显示部门路径
返回数据示例：
"errcode":0,
"errmsg":"请求成功",
"comanyView":"蓝信工场oft05",
"departmentView":"",
"name":"王好",
"mobile":""
"comanyView":"蓝信工场oft05",
"departmentView":"产品中心",
"name":"张松",
"mobile":""
"comanyView":"蓝信工场oft05",
"departmentView":"产品中心",
"name":"戴维张",
"mobile":""
"comanyView":"蓝信工场oft05",
"departmentView":"产品中心-产品部",
"name":"于茜茜",
"mobile":""
"comanyView":"蓝信工场oft05",
"departmentView":"产品中心-产品部",
"name":"刘慧丽",
"mobile":""}
蓝信开放平台接口提供第三方应用与用户进行信息交互、自定义菜单交互的能力。企业可以通过这些接口整合企业应用系统到蓝信，利用蓝信通讯录和即时消息基础功能，可以实现类似微信服务号/订阅号的应用。
蓝信开放平台提供自定义菜单接口，自定义菜单能够帮助公众号丰富界面，让用户更好更快地理解公众号的功能。公众号界面如图所示：
目前自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字，二级菜单最多7个汉字，多出来的部分将会以“...”代替。请注意，创建自定义菜单后，由于蓝信客户端缓存，需要24小时蓝信客户端才会展现出来。
说明：由于客户端会缓存菜单，建议开发时，如果更新了菜单，可以手动删除消息会话列表中的公众号，然后重新推送客服消息，就可以看到更新后的菜单。android客户端也可以清除应用缓存更新客户端菜单显示。
第一步：申请蓝信公众号
联系蓝信平台组织管理员，开通一个蓝信公众号。
第二步：获取token、appid和开发者密钥secret
token用作生成签名，第三方接收开放平台数据时会收到token的签名，通过和本地token比较，验证请求安全性。
appid指开放平台分配给第三方的开发者账号。
secret指开放平台分配给第三方的开发者密钥。
公众号开通后，通过蓝信或者Email将公众号、企业信息、接收消息url（开放平台会将发往开发者的蓝消息推送至该url）信息提交至蓝信开放平台，蓝信开放平台生成开发者需要的token、appid和secret。同样通过蓝信或者Email发送至申请者。
第三步：成为开发者
拿到token、appid和secret后，恭喜您已经成为蓝信开放平台开发者，蓝信开放平台提供了可视化测试工具，访问地址为http://ip:端口/debug，开发者动手开发前可以通过该测试工具体验获取access_token、上传/下载资源文件、发送客服消息、查询菜单等接口。同时，也能进一步理解各个接口的作用。
蓝信开放平台支持http和https，开发者使用接口前，需要用appid和secret换取access_token，access_token是蓝信开放平台的全局唯一凭据，调用各个接口时都需要使用access_token
access_token是动态的、且有时效性，有效时间为7200s。
消息分为客服消息和被动响应消息。
客服消息：公众号主动向用户发送消息。
被动响应消息：用户向公众号发送消息或者菜单事件，公众号作出响应的消息。
1. 客服消息的消息体采用json格式
参数说明：
资源文件ID，附件消息使用
消息中链接，图文和链接消息使用
示例数据：
"touser": "OPENID",
"msgtype": "attachment",
"attachment": {
"media_id": "MEDIA_ID"
被动响应消息的消息体采用xml格式
参数说明：
ToUserName
资源文件ID，附件消息使用
消息中链接，图文和链接消息使用
CreateTime
消息创建时间
示例数据：
&ToUserName&&![CDATA[接收者]]&&/ToUserName&
&FromUserName&&![CDATA[发送者]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[text]]&&/MsgType&
&Content&&![CDATA[你好]]&&/Content&
公众号每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。
全局返回码说明如下：
数据请求失败
不支持公号对公号发送
菜单已存在，请勿重复创建
没有找到对应菜单
无权请求此组织数据
找不到此消息对应的附件，请您检查后重新发送
消息发送失败
获取access_token时AppSecret错误，或者access_token无效
不合法的凭证类型
不合法的文件大小
不合法的媒体文件id
不合法的消息类型
不合法的APPID
不合法的access_token
不合法的菜单类型
不合法的按钮个数
不合法的按钮个数
不合法的按钮名字长度
不合法的按钮KEY长度
不合法的按钮URL长度
不合法的子菜单级数
不合法的子菜单按钮个数
不合法的子菜单按钮类型
不合法的子菜单按钮名字长度
不合法的子菜单按钮KEY长度
不合法的子菜单按钮URL长度
不合法的自定义菜单使用用户
不合法的oauth_code
不合法的refresh_token
不合法的请求字符，不能包含\uxxxx格式的字符
不合法的参数
不合法的请求格式
不合法的URL长度
缺少access_token参数
缺少appid参数
缺少refresh_token参数
缺少secret参数
缺少多媒体文件数据
缺少media_id参数
缺少子菜单数据
缺少oauth code
access_token超时
refresh_token超时
oauth_code超时
需要GET请求
需要POST请求
需要HTTPS请求
多媒体文件为空
POST的数据包为空
图文消息内容为空
文本消息内容为空
消息内容超过限制
标题字段超过限制
描述字段超过限制
链接字段超过限制
图片链接字段超过限制
图文消息超过限制
创建菜单个数超过限制
回复时间超过限制
不存在媒体数据
不存在的菜单版本
不存在的菜单数据
不存在的用户
解析JSON/XML内容错误
api功能未授权
用户未授权该api
auth_token无效
用户认证，sso_token不能为空！
sso_token错误，认证失败！
第三方可从msgcontent获取开放平台推送的消息内容。
开发者接收消息的时候，开放平台将发送POST请求到开发者填写的URL上，并且带了四个参数（singature、timestamp、nonce、echostr），开发者通过对签名（即singature）的校验，来判断消息的真实性。
加密协议：
蓝信加密签名，signature为开发者填写的token和请求中的timestamp、nonce、echostr参数加密的结果
随机字符串
加密/校验流程如下：
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比，结果一样表示该请求来源于蓝信。
当蓝信用户向公众账号发消息时，开放平台将消息POST到开发者填写的URL上。关于重试的消息排重，推荐使用msgid排重
注意：假如开发者服务器无法保证在五秒内处理并回复，可以直接回复空串，开放平台不会对此作出任何处理，并且不会发起重试。
各消息类型协议和数据如下：
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
消息类型text
文本消息内容
示例数据：
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[fromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[text]]&&/MsgType&
&Content&&![CDATA[this is a test]]&&/Content&
&MsgId&3456&/MsgId&
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
attachment
图片消息媒体id，可以调用多媒体文件下载接口拉取数据
示例数据：
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[fromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[attachment]]&&/MsgType&
&MediaId&&![CDATA[mediaId]]&&/MediaId&
&MsgId&3456&/MsgId&
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
链接地址URL
示例数据：
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[fromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[link]]&&/MsgType&
&Url&&![CDATA[url]]&&/Url&
&MsgId&3456&/MsgId&
菜单事件包括CLICK、VIEW、LOCATION、PROXYVIEW，其中CLICK、LOCATION；类型事件会被转发到第三方，第三方可从msgContent获取消息内容，由第三方处理返回响应数据。
开放平台在十秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次 关于重试的消息排重，推荐使用FromUserName + CreateTime 排重。
假如开发者服务器无法保证在十秒内处理并回复，可以直接回复空串，开放平台不会对此作任何处理，并且不会发起重试。
用户点击自定义菜单后，如果菜单按钮设置为click类型，则会把此次点击事件推送给开发者，注意view类型菜单点击，是跳转到url，不会推送事件消息到公众号。
各个事件消息协议和数据如下：
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
消息类型：event表示事件消息类型
事件类型：CLICK菜单事件，将菜单key发送只开发者
菜单KEY，开发者可以通过KEY区分不同业务
示例数据：
&MsgId&-1111&/MsgId&
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[FromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[event]]&&/MsgType&
&Event&&![CDATA[CLICK]]&&/Event&
&EventKey&&![CDATA[EVENTKEY]]&&/EventKey&
创建菜单事件类型为location时，客户端会上报当前地理位置信息。
消息体对象：
ToUserName
开发者公号
FromUserName
发送方帐号
CreateTime
消息创建时间 （长整型）
消息类型：event表示事件消息类型
事件类型：CLICK
Location_X
地理位置纬度
Location_Y
地理位置经度
地图缩放大小
地理位置信息
示例数据：
&MsgId&-1111&/MsgId&
&ToUserName&&![CDATA[ToUserName]]&&/ToUserName&
&FromUserName&&![CDATA[FromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[event]]&&/MsgType&
&Event&&![CDATA[CLICK]]&&/Event&
&Location_X&23.134521&/Location_X&
&Location_Y&113.358803&/Location_Y&
&Scale&20&/Scale&
&Label&&![CDATA[位置信息]]&&/Label&
手机客户端通过公众平台向公号发送消息或者菜单事件，公众平台将消息或者菜单事件转发到第三方的redirect_url，第三方返回给公众平台响应消息（若无响应消息，返回空）。
各消息类型协议和数据如下：
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：text
文本消息内容
示例数据：
&FromUserName&公号&/FromUserName&
&ToUserName&&![CDATA[手机号]]&&/ToUserName&
&CreateTime&时间戳&/CreateTime&
&MsgType&&![CDATA[text]]&&/MsgType&
&Content&&![CDATA[你好]]&&/Content&
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：attachment
附件资源ID，上传附件，由开放平台产生
示例数据：
&FromUserName&公号&/FromUserName&
&ToUserName&&![CDATA[手机号]]&&/ToUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[attachment]]&&/MsgType&
&MediaId&&![CDATA[1]]&&/MediaId&
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：link
示例数据：
&FromUserName&公号&/FromUserName&
&ToUserName&&![CDATA[手机号]]&&/ToUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[link]]&&/MsgType&
&Url&&![CDATA[http://www.baidu.com]]&&/Url&
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：news
图文消息标题
ArticleCount
图文消息个数，限制为10条以内
多条图文消息信息，默认第一个item为大图,注意，如果图文数超过10，则将会无响应
Description
图文消息描述
图片链接，支持JPG、PNG格式，较好的效果为大图360*200，小图200*200
点击图文消息跳转链接
示例数据：
&ToUserName&&![CDATA[toUser]]&&/ToUserName&
&FromUserName&&![CDATA[fromUser]]&&/FromUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[news]]&&/MsgType&
&ArticleCount&2&/ArticleCount&
&Articles&
&Title&&![CDATA[title1]]&&/Title&
&Description&&![CDATA[description1]]&&/Description&
&PicUrl&&![CDATA[picurl]]&&/PicUrl&
&Url&&![CDATA[url]]&&/Url&
&Title&&![CDATA[title]]&&/Title&
&Description&&![CDATA[description]]&&/Description&
&PicUrl&&![CDATA[picurl]]&&/PicUrl&
&Url&&![CDATA[url]]&&/Url&
&/Articles&
消息体对象：
ToUserName
发送方账号
FromUserName
开发者公众号
CreateTime
消息创建时间 （长整型）
消息类型：backGround，view
客户端需要跳转的url
说明：MsgType取值backGround客户端从后台请求Url，取值view则客户端通过webview打开。
示例数据：
&FromUserName&公号&/FromUserName&
&ToUserName&&![CDATA[手机号]]&&/ToUserName&
&CreateTime&&/CreateTime&
&MsgType&&![CDATA[backGround/view]]&&/MsgType&
&Url&&![CDATA[http://ip:端口/xxx]]&&/Url&
使用接口时，采用POST方式传参
http://ip:端口/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
接口描述：
access_token是公众号的全局唯一凭据，公众号调用各接口时，都需要使用access_token。
http请求方式：POST/GET
request参数对象：
grant_type
获取access_token填写client_credential
第三方用户唯一凭证
开发者密钥
参数对象：
access_token
获取到的凭证
expires_in
凭证有效时间，单位：秒
返回数据示例：
成功返回：
"errcode": 0,
"access_token": "ACCESS_TOKEN",
"expires_in": 7200
错误返回：
"errcode": 40013,
"errmsg": "不合法的APPID "
http://ip:端口/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
接口描述：
上传资源文件，文件类型包括：音/视频、图片、office文件等，用于发送附件消息、图文消息。
http请求方式：POST
request参数对象：
access_token
调用接口凭证
媒体文件类型：分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb）
form-data中媒体文件标识，有filename，filelength，content-type等信息
response参数对象：
请求状态码
资源文件ID
返回数据示例：
成功返回：
"errcode": 0,
"type": "TYPE",
"media_id": "MEDIA_ID",
"created_at":
错误返回：
"errcode": 40004,
"errmsg": "不合法的媒体文件类型"
http://ip:端口/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
下载文件。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
媒体文件ID
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回数据示例：
成功返回http头如下：
HTTP/1.1 200 OK
Connection: close
Content-Type: image/jpeg
Content-disposition: filename="MEDIA_ID.jpg"
Date: Sun, 06 Jan :18 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 339721
curl -G "http://ip：端口/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"
错误返回：
"errcode": 40007,
"errmsg": "不合法的媒体文件id"
注意：此接口可以用于获取用户头像
http://ip:端口/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
接口描述：
发送客服消息指公众号向手机客户端发送消息。支持发送文本、附件、链接、图文、邮件消息
http请求方式：POST，POST一个JSON数据包来发送消息
request参数对象：
access_token
调用接口凭证
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
返回数据示例：
成功返回：
"errcode": 0,
"errmsg": "请求成功"
错误返回：
"errcode": 40014,
"errmsg": "不合法的access_token "
消息体说明如下：
消息体对象：
接收方帐号
消息类型：text
文本消息内容
"touser": "手机号",
"msgtype": "text",
"content": "Hello World"
支持图片、音频、视频、office文件等附件消息。
消息体对象：
接收方帐号
消息类型：attachment
附件资源文件ID
"touser": "OPENID",
"msgtype": "attachment",
"title":"标题"
"attachment": {
"media_id": "MEDIA_ID"
消息体对象：
接收方帐号
消息类型：link
"touser": "OPENID",
"msgtype": "link",
"url": "http://www.lanxin.cn"
图文消息条数限制在10条以内，注意，如果图文数超过10，则将会无响应。
消息体对象：
接收方帐号
消息类型：news
description
点击后跳转的链接
图文消息的图片链接
图文消息链接类型，默认值为0：0 URL；1 语音； 2 视频； 3 文档 ； 4 未知
int类型：0 默认值，可以不传；1. 访问link的时候增加name和telephone要求以_ckey为可以传递。例如：http://host/path/uri?_ckey=base64(name=name&telephone=telephon)
"touser": "手机号",
"msgtype": "news",
"articles": [{
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"picurl": "PIC_URL",
"type": 0,
"flag": 0},
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"picurl": "PIC_URL",
"type": 0,
"flag": 0}]
邮件消息是一种特殊的图文消息。
消息体对象：
接收方帐号
消息类型：mail
邮件消息链接地址
邮件消息标题
"touser": "OPENID",
"msgtype": "mail",
"url": "http://www.lanxin.cn",
"title": "邮件标题"
重要说明：
1) 邮件消息url返回数据对象：
有无附件标识，0-无附件；1-有附件
邮件打开链接
新邮件文本内容
发送者邮箱
邮件发送时间
2) 示例数据：
"flag": 0,
"link": "http://ip:端口/lanxin_opc_360cloud/videoTest.jsp",
"mainText”:”新邮件文本内容",
"mailFrom": "",
"time": "14-05-23 15:30",
"title": "邮件标题"
http://ip:端口/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN
接口描述：
群发消息指第三方向多人或者多组织（分支部门）的成员发送消息。
http请求方式：POST，POST一个JSON数据包来发送消息
request参数对象：
access_token
调用接口凭证
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
返回数据示例：
成功返回：
"errcode": 0,
"errmsg": "请求成功"
错误返回：
"errcode": 40014,
"errmsg": "不合法的access_token "
消息体说明如下：
消息体对象：
多个接收方手机号，多个以“,”间隔
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：text
文本消息内容
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "text",
"content": "Hello World"
支持图片、音频、视频、office文件等附件消息。
消息体对象：
多个接收方手机号，多个以“,”间隔
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：attachment
附件资源文件ID
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "attachment",
"title":"标题",
"attachment": {
"media_id": "MEDIA_ID"
消息体对象：
多个接收方手机号，多个以“,”间隔
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：link
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "link",
"url": "http://www.lanxin.cn"
图文消息条数限制在10条以内，注意，如果图文数超过10，则将会无响应。
消息体对象：
多个接收方手机号，多个以“,”间隔，tousers和togroups二者至少有一个
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：news
description
点击后跳转的链接
图文消息的图片链接
图文消息链接类型，默认值为0：0 URL；1 语音； 2 视频； 3 文档 ； 4 未知
int类型：0 默认值，可以不传；1. 访问link的时候增加name和telephone要求以_ckey为可以传递。例如：http://host/path/uri?_ckey=base64(name=name&telephone=telephon)
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "news",
"articles": [
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"picurl": "PIC_URL",
"type": 0,
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"picurl": "PIC_URL",
"type": 0,
邮件消息是一种特殊的图文消息。
消息体对象：
多个接收方手机号，多个以“,”间隔
多个接收方分支ID，多个以“,”间隔
true:群发给整个组织;false:按照tousers、togroups群发
消息类型：mail
邮件消息链接地址
邮件消息标题
"toall": true,
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "mail",
"url": "http://www.lanxin.cn",
"title": "邮件标题"
重要说明：
1) 邮件消息url返回数据对象：
有无附件标识，0-无附件；1-有附件
邮件打开链接
新邮件文本内容
发送者邮箱
邮件发送时间
2) 示例数据：
"flag": 0,
"link": "http://ip:端口/lanxin_opc_360cloud/videoTest.jsp",
"mainText”:”新邮件文本内容",
"mailFrom": "",
"time": "14-05-23 15:30",
"title": "邮件标题"
http://ip:端口/cgi-bin/member/get?access_token=ACCESS_TOKEN&orgId=ORGID&mobile=MOBILE&email=EMAIL
接口描述：
查询成员信息，此接口缓存时间为5分钟，非实时数据
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
待查询成员手机号
待查询成员email
注：mobile和email填写一个即可，优先取mobile进行查询
response参数对象(当返回的数据中某个字段的值为null时，该key-value在报文中不显示)：
返回状态描述
成员在组织中的位置(code路径)
用户标识符
成员所在公司名称，对应蓝信中的“单位”，一般和orgName一样。如果为集团公司，company一般为集团子公司名称
photoResId
头像资源ID（头像不存在时报文中无此字段）
所属单位ID
成员所在组织名称，一般和company一样。如果是集团公司，orgName为集团名称
secondPosition
业务属性列表
职务属性列表
contactExs
联系方式扩展
serialNumber
序列号，如警号
备注，说明
成员在组织中的位置
orgName、company、path关系说明：
如上图所示：
orgName: 集团名称。
company：集团下子公司名称
path：张三在组织机构中的位置path为orgName-company1-研发中心
非集团公司
如上图所示：
orgName和company一样，都表示公司的名称。
path：张三在组织机构中的位置path为orgName/company-技术开发部-张三。
返回数据示例：
"errcode": 0,
"errmsg": "请求成功",
"openOrgMemberList": [
mobile: "",
orgId: 34,
userUniId:"83191@34.uni1",
company:"蓝信工厂",
photoResId:"fe7cf9a1-e5b4-d72c05e24d",
parentId: 111111,
email: "",
companyId:594771,
orgName: "蓝信工场",
secondPosition: "",
contactExs:
position:"",
serialNumber:"",
name: "杨雪",
code : "34-594771",
"path": "蓝信工场-研发部",
mobile: "",
orgId: 34,
userUniId:"83191@34.uni1",
company:"蓝信工厂",
photoResId:"fe7cf9a1-e5b4-d72c05e24d",
parentId: 111111,
email: "",
companyId:594771,
orgName: "蓝信工场",
secondPosition: "",
contactExs:
position:"",
serialNumber:"",
name: "杨雪",
code : "34-594772",
path: "蓝信工场-产品部",
http://ip:端口/cgi-bin/org/struct/parent/get?access_token=ACCESS_TOKEN&orgId=ORGID&structId=STRUCTID&queryType=QUERYTYPE
接口描述：
根据组织和分支ID查询分支下的数据,可用于展示组织结构和人员信息。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
分支ID，为0时表示从根节点查询
0:分支节点;1:成员节点;-1:全部节点
response参数对象(当返回的数据中某个字段的值为null时，该key-value在报文中不显示)：
返回状态描述
openOrgStructList
分支机构列表
分支所在位置
分支父级机构，为0时，表示当前节点为根节点
openOrgMemberList
成员所在组织位置
成员所在组织名称
成员所在组织id
成员所在公司
成员在组织中的位置(code路径)
返回数据示例：
"openOrgStructList": [
"name": "北京分公司",
"path": "蓝信工场-一级分支-二级分支-北京分公司",
"code" : "34-792-594743",
"parentId": 5
"name": "上海分公司",
"path": "蓝信工场-一级分支-二级分支-上海分公司",
"code" : "34-792-594749",
"parentId": 5
"openOrgMemberList": [
"id": 1113,
"name": "杨雪",
"userUniId":"87284@34.uni1",
photoResId:"fe7cf9a1-e5b4-d72c05e24d",
"email": "",
"mobile": "",
"path": "蓝信工场-一级分支-二级分支",
"code" : "34-792-594743",
"orgName": "蓝信工场",
"orgId": 1,
"company": "蓝信工场"
"id": 1104,
"name": "杨冰",
"userUniId":"87285@34.uni1",
photoResId:"4t64cf9a1-e5b4-d72c0534e1",
"email": "",
"mobile": "",
"path": "蓝信工场-一级分支-二级分支",
"code" : "34-792-594743",
"orgName": "蓝信工场",
"orgId": 1,
"company": "蓝信工场"
"errmsg": "请求成功",
"errcode": 0
http://ip:端口/cgi-bin/message/control?access_token=ACCESS_TOKEN&msgId=MSGID
接口描述：
查询消息送达状态，支持客服消息、群发消息的状态查询。
注：要记录消息送达状态数据量会很大，默认状态下是不保存发送状态的。如果想要记录消息发送状态，需在发送的消息报文体中加入needSendingState字段
"touser": "手机号",
"msgtype": "text",
"needSendingState": 1,
"content": "Hello World"
"tousers": ["手机号1","手机号2"],
"togroups": ["分支1","分支2"],
"msgtype": "text",
"needSendingState": 1,
"content": "Hello World"
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
待查询消息ID
response参数对象：
返回状态描述
sendingState
userMessageId
recieveTime
userMessageBodyId
返回数据示例：
"msgSendStateList":[{
"sendingState":0,
"mobile":"",
"dialogId":"100909",
"sendTime":0,
"userMessageId":234845,
"recieveTime":0,
"userMessageBodyId":136277,
"readTime":0
"errmsg":"请求成功",
"errcode":0
"msgSendStateList":[
"dialogId":"100909",
"sendingState":0,
"sendTime":0,
"userMessageId":232211,
"mobile":"",
"recieveTime":0,
"readTime":0,
"userMessageBodyId":134908
"dialogId":"100909",
"sendingState":0,
"sendTime":0,
"userMessageId":232212,
"mobile":"",
"recieveTime":0,
"readTime":0,
"userMessageBodyId":134908
"errmsg":"请求成功",
"errcode":0
http://ip:端口/cgi-bin/menu/create?access_token=ACCESS_TOKEN
接口描述：
创建自定义菜单。
http请求方式：POST，POST一个JSON数据包
request参数对象：
access_token
调用接口凭证
菜单参数说明：
一级菜单数组，个数应为1~3个
sub_button
二级菜单数组，个数应为1~5个
菜单的响应动作类型，目前有click、view、location、proxyView四种类型
菜单标题，不超过16个字节，子菜单不超过40个字节
菜单KEY值，用于消息接口推送，不超过128字节
1 oauth菜单view类型使用，0或者不传普通view类型
网页链接，用户点击菜单可打开链接，不超过256字节
示例数据：
"button": [
"type": "click",
"name": "今日歌曲",
"key": "V1001_TODAY_MUSIC"
"type": "click",
"name": "歌手简介",
"key": "V1001_TODAY_SINGER"
"type": "click",
"name": "签到",
"key": "qiandaokey"
"name": "菜单",
"sub_button": [
"type": "view",
"name": "搜索",
"url": "https://www.soso.com/"，
"type": "view",
"name": "视频",
"url": "https://v.lanxin.com/"
"type": "click",
"name": "赞一下我们",
"key": "V1001_GOOD"
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
返回数据示例：
a) 成功返回：
"errcode": 0,
"errmsg": "请求成功"
b) 错误返回：
"errcode": 40018,
"errmsg": "不合法的按钮名字长度"
http://ip:端口/cgi-bin/menu/get?access_token=ACCESS_TOKEN
接口描述：
查询菜单。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
response参数对象：
菜单数据列表
一级菜单数组，个数应为1~3个
sub_button
二级菜单数组，个数应为1~5个
菜单的响应动作类型，目前有click、view、location、proxyView四种类型
菜单标题，不超过16个字节，子菜单不超过40个字节
菜单KEY值，用于消息接口推送，不超过128字节
网页链接，用户点击菜单可打开链接，不超过256字节
返回数据示例：
"errcode": 0,
"errmsg": "请求成功",
"button": [
"type": "click",
"name": "今日歌曲",
"key": "V1001_TODAY_MUSIC",
"sub_button": []
"type": "click",
"name": "歌手简介",
"key": "V1001_TODAY_SINGER",
"sub_button": []
"name": "菜单",
"sub_button": [
"type": "view",
"name": "搜索",
"url": "https://www.soso.com/",
"sub_button": []
"type": "view",
"name": "视频",
"url": "https://v.lanxin.com/",
"sub_button": []
"type": "click",
"name": "赞一下我们",
"key": "V1001_GOOD",
"sub_button": []
http://ip:端口/cgi-bin/menu/delete?access_token=ACCESS_TOKEN
接口描述：
删除菜单。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
返回数据示例：
"errcode": 0,
"errmsg": "请求成功"
http://ip:端口/cgi-bin/user/ssoauth?access_token=ACCESS_TOKEN
接口描述：
通过认证令牌验证用户，返回用户的登录名（手机号码）。
http请求方式：POST/GET
request参数对象：
access_token
调用接口凭证
response参数对象：
状态码，参照1.2.4中全局返回码说明
返回信息描述
ssotoken对应的用户登录名（手机号码）
返回数据示例：
"errcode": 0,
"errmsg": "请求成功",
"mobile": ""
接口描述：
通过手机号获取该手机号对应的联系人信息（信息包括：name，userid，useruniid，company，path 五个字段）
Http请求方式: GET
http://ip:端口/lop-client/orgMember?access_token=ACCESS_TOKEN&mobile=MOBILE
http://oft05-open.e.lanxin.cn/cgi-bin/orgMember?access_token=f58b045feffb90ad0f098e3e2deb0feaa&mobile=
参数说明：
access_token
令牌，根据appid和secret获取
response参数对象：
comanyView
departmentView
显示部门路径
返回数据示例：
"errcode":0,
"errmsg":"请求成功",
"comanyView":"蓝信工场oft05",
"departmentView":"",
"name":"王好",
"mobile":""
"comanyView":"蓝信工场oft05",
"departmentView":"产品中心",
"name":"张松",
"mobile":""
"comanyView":"蓝信工场oft05",
"departmentView":"产品中心",
"name":"戴维张",
"mobile":""
"comanyView":"蓝信工场oft05",
"departmentView":"产品中心-产品部",
"name":"于茜茜",
"mobile":""
"comanyView":"蓝信工场oft05",
"departmentView":"产品中心-产品部",
"name":"刘慧丽",
"mobile":""}
我要回帖
更多关于 手机号变更短信 的文章
更多推荐
- ·惠来做屋顶琉璃瓦怎么做水槽屋顶哪家好？
- ·如何从pcb文件中提取原理图到pcb的步骤
- ·你写的这个自毁程序，在excel中可以用，但是不能在powerpoint无法打开此种文件类型里面使用，能指点迷津吗？
- ·如何彻底的关闭机械键盘怎么调跑马灯的背光功能？
- ·新疆隔壁摊捡的红色石头一般是啥石头的石头是什么石头
- ·全民飞机大战进阶歼15120级歼15进阶费用是多少?
- ·我要部落冲突账号免费送号。求送
- ·除了补充里的还有哪些红警mod2mod最好玩？常玩红警mod2的推荐下
- ·360n7的游戏加速器2.0打王者加速器开高帧率是会把机型修改成什么
- ·lol脚本lol洲际赛门票哪里买？
- ·求ps3上ps3e3破解iso游戏下载的高达vsfb的ios资源。要是全dlc也好。要是没有也行。感谢各位
- ·造梦西游3OL内有个图标是熊猫什么版本
- ·不知道带助听器进考场证明的效果，所以一直没敢购买
- ·请问红米Note5在美团外卖必须实体店吗是怎么卖的？
- ·罗技G633打开罗技耳机麦克风回音耳机喇叭总是滴滴响别的都不影响
- ·小米稳定版无法卡刷卡刷MIUI10，显示安装包非最新，什么鬼
- ·在办什么套餐或卡、够7G联通流量套餐办理总话费不过50
- ·手机上东吴证券官网秀财开了夜间模式如何更改过来?
- ·成吉思汗新皮肤冰原狼这机箱怎么样
- ·蓝信用户如何变更手机号变更通知短信?
- ·u盘电脑读不出来u盘，教您u盘电脑读不出来u盘如何修复
- ·em0492-02a光动能手表换电池这款手表是真的吗 用着怎么样
- ·明天除了更新这个，还有其他英雄联盟更新公告告吗
- ·哪些流量卡会比联通的联通88元无限流量套餐冰淇淋套餐便宜
- ·换8脚IC型号不一样为什么会短路过渡 弧焊电源 电源部分
- ·外星人敢死队背包真假便携式VR背包：背的不是梦想 是电脑
- ·版单独设置域名，像很多大的网站域名设置都有m开头做手机版网
- ·360N7如何钉钉打卡迟到怎么修改定位修改
- ·正反转电路图接线方法线路
- ·劳力士的劳力士格林尼治和水鬼系列，怎么读第三时区？
- ·求 that girthat gril olly murss mp3下载地址
- ·电脑开机故障怎么检查问题
- ·小米手机更新了几次，怎么查看出厂小米查看系统版本本
- ·WII手柄能在wiiu pro手柄上使用吗
