Senparc.Weixin.QY 管理企业号应用 获取企业号应用信息 企业应用的id,可在应用的设置页面查看 代理请求超时时间(毫秒) 设置企业号应用 此App只能修改现有的并且有权限管理的应用,无法创建新应用(因为新应用没有权限) 设置应用需要Post的数据 代理请求超时时间(毫秒) 获取应用概况列表 代理请求超时时间(毫秒) 获取企业号应用返回结果 企业应用id 企业应用名称 企业应用方形头像 企业应用圆形头像 企业应用详情 企业应用可见范围(人员),其中包括userid和关注状态state 企业应用可见范围(部门) 企业应用可见范围(标签) 企业应用是否被禁用 企业应用可信域名 企业应用是否打开地理位置上报 0:不上报;1:进入会话上报;2:持续上报 是否接收用户变更通知。0:不接收;1:接收 是否上报用户进入应用事件。0:不接收;1:接收 设置企业号应用需要Post的数据 企业应用id 企业应用名称 企业应用方形头像 企业应用圆形头像 设置企业号应用需要Post的数据 企业应用id 企业应用是否打开地理位置上报 0:不上报;1:进入会话上报;2:持续上报 企业应用头像的mediaid,通过多媒体接口上传图片获得mediaid,上传后会自动裁剪成方形和圆形两个头像 企业应用名称 企业应用详情 企业应用可信域名 是否接收用户变更通知。0:不接收;1:接收 是否上报用户进入应用事件。0:不接收;1:接收 异步任务接口 邀请成员关注 企业的access_token 成员ID列表,多个接收者用‘|’分隔,最多支持1000个。 部门ID列表,多个接收者用‘|’分隔,最多支持100个。 标签ID列表,多个接收者用‘|’分隔。 推送到微信上的提示语(只有认证号可以使用)。当使用微信推送时,该字段默认为“请关注XXX企业号”,邮件邀请时,该字段无效。 回调信息。任务完成后,通过callback推送事件给企业。具体请参考应用回调模式中的相应选项 post数据格式: { "touser":"xxx|xxx", "toparty":"xxx|xxx", "totag":"xxx|xxx", "invite_tips":"xxx", "callback": { "url": "xxx", "token": "xxx", "encodingaeskey": "xxx" } } 增量更新成员 CSV模板下载地址:http://qydev.weixin.qq.com/batch_user_sample.csv 注意事项: 1.模板中的部门需填写部门ID,多个部门用分号分隔,部门ID必须为数字 2.文件中存在、通讯录中也存在的成员,更新成员在文件中指定的字段值 3.文件中存在、通讯录中不存在的成员,执行添加操作 4.通讯录中存在、文件中不存在的成员,保持不变 上传的csv文件的media_id 回调信息。任务完成后,通过callback推送事件给企业。具体请参考应用回调模式中的相应选项 post数据格式: { "media_id":"xxxxxx", "callback": { "url": "xxx", "token": "xxx", "encodingaeskey": "xxx" } } 全量覆盖成员 CSV模板下载地址:http://qydev.weixin.qq.com/batch_user_sample.csv 注意事项: 1.模板中的部门需填写部门ID,多个部门用分号分隔,部门ID必须为数字 2.文件中存在、通讯录中也存在的成员,完全以文件为准 3.文件中存在、通讯录中不存在的成员,执行添加操作 4.通讯录中存在、文件中不存在的成员,执行删除操作。出于安全考虑,如果需要删除的成员多于50人,且多于现有人数的20%以上,系统将中止导入并返回相应的错误码 上传的csv文件的media_id 回调信息。任务完成后,通过callback推送事件给企业。具体请参考应用回调模式中的相应选项 post数据格式: { "media_id":"xxxxxx", "callback": { "url": "xxx", "token": "xxx", "encodingaeskey": "xxx" } } 全量覆盖部门 CSV模板下载地址:http://qydev.weixin.qq.com/batch_party_sample.csv 注意事项: 1.文件中存在、通讯录中也存在的部门,执行修改操作 2.文件中存在、通讯录中不存在的部门,执行添加操作 3.文件中不存在、通讯录中存在的部门,当部门为空时,执行删除操作 4.CSV文件中,部门名称、部门ID、父部门ID为必填字段,部门ID必须为数字;排序为可选字段,置空或填0不修改排序 上传的csv文件的media_id 回调信息。任务完成后,通过callback推送事件给企业。具体请参考应用回调模式中的相应选项 post数据格式: { "media_id":"xxxxxx", "callback": { "url": "xxx", "token": "xxx", "encodingaeskey": "xxx" } } 获取异步邀请成员关注结果 获取异步更新或全面覆盖成员结果 获取异步全面覆盖部门结果 异步任务Id返回结果 异步任务id,最大长度为64字符 任务状态,整型,1表示任务开始,2表示任务进行中,3表示任务已完成 操作类型,字符串,目前分别有: 1. sync_user(增量更新成员) 2. replace_user(全量覆盖成员) 3. invite_user(邀请成员关注) 4. replace_party(全量覆盖部门) 任务运行总条数 目前运行百分比,当任务完成时为100 预估剩余时间(单位:分钟),当任务完成时为0 异步邀请成员返回结果 成员UserID。对应管理端的帐号 邀请类型:0 没有邀请方式或未邀请 1 微信邀请 2 邮件邀请 异步新增或更新成员返回结果 成员UserID。对应管理端的帐号 操作类型(按位或):1 表示修改,2 表示新增 异步覆盖部门返回结果 部门ID 操作类型(按位或):1 新建部门 ,2 更改部门名称, 4 移动部门, 8 修改部门排序 创建会话 会话id。字符串类型,最长32个字符。只允许字符0-9及字母a-zA-Z, 如果值内容为64bit无符号整型:要求值范围在[1, 2^63)之间,[2^63, 2^64)为系统分配会话id区间 会话标题 管理员userid,必须是该会话userlist的成员之一 会话成员列表,成员用userid来标识。会话成员必须在3人或以上,1000人以下 获取会话 修改会话信息 会话id 操作人userid 会话标题 管理员userid,必须是该会话userlist的成员之一 会话新增成员列表,成员用userid来标识 会话退出成员列表,成员用userid来标识 退出会话 清除消息未读状态 会话所有者的userid 会话类型:single|group,分别表示:群聊|单聊 会话值,为userid|chatid,分别表示:成员id|会话id,单聊是userid,群聊是chatid 发消息 发送人的userId 接收人类型:single|group,分别表示:群聊|单聊 消息类型,text|image|file 会话值,为userid|chatid,分别表示:成员id|会话id,单聊是userid,群聊是chatid 文本消息是content,图片或文件是mediaId 设置成员新消息免打扰 成员新消息免打扰参数,数组,最大支持10000个成员 发送消息基础数据 接收人 发送人 消息类型 接收人类型:single|group,分别表示:群聊|单聊 接收人的值,为userid|chatid,分别表示:成员id|会话id 发送text消息数据 消息内容 发送image消息数据 图片媒体文件id,可以调用上传素材文件接口获取 发送file消息数据 图片媒体文件id,可以调用上传素材文件接口获取 成员新消息免打扰参数 成员UserID 免打扰状态 获取会话返回结果 会话信息 会话id 会话标题 管理员userid 会话成员列表,成员用userid来标识 设置成员新消息免打扰返回结果 列表中不存在的成员会返回在invaliduser里,剩余合法成员会继续执行 关注与取消关注 二次验证 调用接口凭证 员工UserID 获取企业号管理员登录信息 服务提供商的accesstoken oauth2.0授权企业号管理员登录产生的code 代理请求超时时间(毫秒) 获取企业号管理员登录信息返回结果 是否系统管理员 是否内部管理员 登录管理员的信息 授权方企业信息 该管理员在该提供商中能使用的应用列表 该管理员拥有的通讯录权限 管理员邮箱 该管理员的userid(仅为内部管理员时展示) 该管理员的名字(仅为内部管理员时展示) 该管理员的头像(仅为内部管理员时展示) 该管理员的手机(仅为内部管理员时展示) 授权方企业号id 授权方企业号名称 授权方企业号类型,认证号:verified, 注册号:unverified,体验号:test 授权方企业号圆形头像 授权方企业号方形头像 授权方企业号用户规模 授权方企业号应用规模 应用id 该管理员对应用的权限:1.管理权限,0.使用权限 获取永久图文素材返回结果 类型 获取素材总数返回结果 应用素材总数目 图片素材总数目 音频素材总数目 视频素材总数目 文件素材总数目 图文素材总数目 获取素材列表返回结果 素材类型,可以为图文(mpnews)、图片(image)、音频(voice)、视频(video)、文件(file) 应用该类型素材总数目 返回该类型素材数目 素材列表 素材的媒体id 文件名 修改时间 图文消息,一个图文消息支持1到10个图文 获取设备及用户信息 摇周边业务的ticket,可在摇到的URL中得到,ticket生效时间为30分钟,每一次摇都会重新生成新的ticket 获取设备及用户信息返回结果 摇周边页面唯一ID 设备信息,包括UUID、major、minor,以及距离 企业号成员的userid 企业号父号下用户的openid,非企业关注成员的标识,对当前企业号唯一 Beacon信号与手机的距离,单位为米 UUID 获取应用套件令牌 应用套件id 应用套件secret 微信后台推送的ticket 代理请求超时时间(毫秒) 获取预授权码 应用套件id 应用id,本参数选填,表示用户能对本套件内的哪些应用授权,不填时默认用户有全部授权权限 代理请求超时时间(毫秒) 获取企业号的永久授权码 应用套件id 临时授权码会在授权成功时附加在redirect_uri中跳转回应用提供商网站。 代理请求超时时间(毫秒) 获取企业号的授权信息 应用套件id 授权方corpid 永久授权码,通过get_permanent_code获取 代理请求超时时间(毫秒) 获取企业号应用 应用套件id 授权方corpid 永久授权码,从get_permanent_code接口中获取 授权方应用id 代理请求超时时间(毫秒) 设置企业号应用 应用套件id 授权方corpid 永久授权码,从get_permanent_code接口中获取 要设置的企业应用的信息 代理请求超时时间(毫秒) 获取企业号access_token 应用套件id 授权方corpid 永久授权码,通过get_permanent_code获取 代理请求超时时间(毫秒) 获取应用套件令牌返回结果 应用套件access_token 有效期 获取预授权码返回结果 预授权码 有效期 授权方(企业)access_token 授权方(企业)access_token超时时间 企业号永久授权码 授权方企业信息 授权信息 授权方企业号id 授权方企业号名称 授权方企业号类型,认证号:verified, 注册号:unverified,体验号:test 授权方企业号圆形头像 授权方企业号方形头像 授权方企业号用户规模 授权方企业号应用规模 授权的应用信息 授权的通讯录部门 授权方应用id 授权方应用名字 授权方应用方形头像 授权方应用圆形头像 服务商套件中的对应应用id 授权方应用敏感权限组,目前仅有get_location,表示是否有权限设置应用获取地理位置的开关 部门id 部门名称 父部门id 是否具有该部门的写权限 获取企业号的授权信息返回结果 授权方企业信息 授权信息 授权方企业应用id 授权方企业应用名称 授权方企业应用方形头像 授权方企业应用圆形头像 授权方企业应用详情 授权方企业应用可见范围(人员),其中包括userid和关注状态state 授权方企业应用可见范围(部门) 授权方企业应用可见范围(标签) 授权方企业应用是否被禁用 授权方企业应用可信域名 授权方企业应用是否打开地理位置上报 0:不上报;1:进入会话上报;2:持续上报 是否接收用户变更通知。0:不接收;1:接收 获取企业号access_token返回结果 授权方(企业)access_token 授权方(企业)access_token超时时间 企业应用的id 企业应用是否打开地理位置上报 0:不上报;1:进入会话上报;2:持续上报 企业应用头像的mediaid,通过多媒体接口上传图片获得mediaid,上传后会自动裁剪成方形和圆形两个头像 企业应用名称 企业应用详情 企业应用可信域名 是否接收用户变更通知。0:不接收;1:接收 通用接口JsApiTicket容器,用于自动管理JsApiTicket,如果过期会重新获取 注册应用凭证信息,此操作只是注册,不会马上获取Ticket,并将清空之前的Ticket, 使用完整的应用凭证获取Ticket,如果不存在将自动注册 获取可用Ticket 是否强制重新获取新的Ticket 获取可用Ticket 是否强制重新获取新的Ticket 检查是否已经注册 只针对这个CorpId的锁 通用接口ProviderToken容器,用于自动管理ProviderToken,如果过期会重新获取 注册应用凭证信息,此操作只是注册,不会马上获取Token,并将清空之前的Token, 使用完整的应用凭证获取Token,如果不存在将自动注册 获取可用Token 是否强制重新获取新的Token 获取可用Token 是否强制重新获取新的Token 检查是否已经注册 openid转换成userid接口返回的Json结果 该openid在企业号中对应的成员userid 发送消息 发送文本信息 调用接口凭证 UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送 PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 企业应用的id,可在应用的设置页面查看 消息内容 表示是否是保密消息,0表示否,1表示是,默认0 代理请求超时时间(毫秒) 发送图片消息 调用接口凭证 UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送 PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 企业应用的id,可在应用的设置页面查看 媒体资源文件ID 表示是否是保密消息,0表示否,1表示是,默认0 代理请求超时时间(毫秒) 发送语音消息 调用接口凭证 UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送 PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 企业应用的id,可在应用的设置页面查看 媒体资源文件ID 表示是否是保密消息,0表示否,1表示是,默认0 代理请求超时时间(毫秒) 发送视频消息 调用接口凭证 UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送 PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 企业应用的id,可在应用的设置页面查看 媒体资源文件ID 视频消息的标题 视频消息的描述 表示是否是保密消息,0表示否,1表示是,默认0 代理请求超时时间(毫秒) 发送文件消息 调用接口凭证 UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送 PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 企业应用的id,可在应用的设置页面查看 媒体资源文件ID 表示是否是保密消息,0表示否,1表示是,默认0 代理请求超时时间(毫秒) 发送图文消息 调用接口凭证 UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送 PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 企业应用的id,可在应用的设置页面查看 图文信息内容,包括title(标题)、description(描述)、url(点击后跳转的链接。企业可根据url里面带的code参数校验员工的真实身份)和picurl(图文消息的图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80。如不填,在客户端不显示图片) 表示是否是保密消息,0表示否,1表示是,默认0 代理请求超时时间(毫秒) 发送mpnews消息 注:mpnews消息与news消息类似,不同的是图文消息内容存储在微信后台,并且支持保密选项。 调用接口凭证 UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送 PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数 企业应用的id,可在应用的设置页面查看 表示是否是保密消息,0表示否,1表示是,默认0 代理请求超时时间(毫秒) 发送消息返回结果 如果对应用或收件人、部门、标签任何一个无权限,则本次发送失败;如果收件人、部门或标签不存在,发送仍然执行,但返回无效的部分。 创建部门 调用接口凭证 部门名称。长度限制为1~64个字符 父亲部门id。根部门id为1 在父部门中的次序。从1开始,数字越大排序越靠后 部门ID。用指定部门ID新建部门,不指定此参数时,则自动生成 代理请求超时时间(毫秒) 更新部门 调用接口凭证 部门id 更新的部门名称。长度限制为0~64个字符。修改部门名称时指定该参数 父亲部门id。根部门id为1 在父部门中的次序。从1开始,数字越大排序越靠后 代理请求超时时间(毫秒) 删除部门 调用接口凭证 部门id。(注:不能删除根部门;不能删除含有子部门、成员的部门) 获取部门列表 调用接口凭证 部门ID。获取指定部门ID下的子部门 创建成员(mobile/weixinid/email三者不能同时为空) 调用接口凭证 员工UserID。必须企业内唯一 成员名称。长度为1~64个字符 成员所属部门id列表。注意,每个部门的直属员工上限为1000个 职位信息。长度为0~64个字符 手机号码。必须企业内唯一 办公电话。长度为0~64个字符 邮箱。长度为0~64个字符。必须企业内唯一 微信号。必须企业内唯一 性别。gender=0表示男,=1表示女。默认gender=0 扩展属性。扩展属性需要在WEB管理端创建后才生效,否则忽略未知属性的赋值 代理请求超时时间(毫秒) accessToken、userId和name为必须的参数,其余参数不是必须的,可以传入null 更新成员(mobile/weixinid/email三者不能同时为空) 调用接口凭证 员工UserID。必须企业内唯一 成员名称。长度为1~64个字符 成员所属部门id列表。注意,每个部门的直属员工上限为1000个 职位信息。长度为0~64个字符 手机号码。必须企业内唯一 邮箱。长度为0~64个字符。必须企业内唯一 微信号。必须企业内唯一 启用/禁用成员。1表示启用成员,0表示禁用成员 扩展属性。扩展属性需要在WEB管理端创建后才生效,否则忽略未知属性的赋值 代理请求超时时间(毫秒) accessToken和userId为必须的参数,其余参数不是必须的,可以传入null 删除成员 调用接口凭证 员工UserID 批量删除成员 代理请求超时时间(毫秒) 获取成员 调用接口凭证 员工UserID 获取部门成员 调用接口凭证 获取的部门id 1/0:是否递归获取子部门下面的成员 0获取全部员工,1获取已关注成员列表,2获取禁用成员列表,4获取未关注成员列表。status可叠加 获取部门成员(详情) 调用接口凭证 获取的部门id 1/0:是否递归获取子部门下面的成员 0获取全部员工,1获取已关注成员列表,2获取禁用成员列表,4获取未关注成员列表。status可叠加 邀请成员关注 认证号优先使用微信推送邀请关注,如果没有weixinid字段则依次对手机号,邮箱绑定的微信进行推送,全部没有匹配则通过邮件邀请关注。 邮箱字段无效则邀请失败。 非认证号只通过邮件邀请关注。邮箱字段无效则邀请失败。 已关注以及被禁用用户不允许发起邀请关注请求。 测试发现同一个邮箱只发送一封邀请关注邮件,第二次再对此邮箱发送微信会提示系统错误 调用接口凭证 用户的userid 推送到微信上的提示语(只有认证号可以使用)。当使用微信推送时,该字段默认为“请关注XXX企业号”,邮件邀请时,该字段无效。 代理请求超时时间(毫秒) 创建标签 调用接口凭证 标签名称。长度为1~64个字符,标签不可与其他同组的标签重名,也不可与全局标签重名 标签id,整型,指定此参数时新增的标签会生成对应的标签id,不指定时则以目前最大的id自增。 代理请求超时时间(毫秒) 更新标签名字 调用接口凭证 标签ID 标签名称。长度为0~64个字符 代理请求超时时间(毫秒) 删除标签 调用接口凭证 标签ID 获取标签成员 调用接口凭证 标签ID 增加标签成员 调用接口凭证 标签ID 企业成员ID列表,注意:userlist、partylist不能同时为空 企业部门ID列表,注意:userlist、partylist不能同时为空 代理请求超时时间(毫秒) 删除标签成员 调用接口凭证 标签ID 企业员工ID列表 代理请求超时时间(毫秒) 获取标签列表 创建部门返回结果 创建的部门id 部门id 部门名称 上级部门id 在父部门中的次序值。order值小的排序靠前。 员工UserID 成员名称 成员所属部门id列表 职位信息 手机号码 性别。gender=0表示男,=1表示女 邮箱 微信号 头像url。注:小图将url最后的"/0"改成"/64" 关注状态: 1=已关注,2=已冻结,4=未关注 扩展属性 成员列表 员工UserID 成员名称 扩展属性 获取部门成员(详情)返回结果 成员列表 1:微信邀请 2.邮件邀请 创建标签返回结果 标签id 获取标签成员返回结果 成员列表 部门列表 员工UserID 成员名称 添加标签成员返回结果 a)正确时返回{"errcode": 0,"errmsg": "ok"} b)若部分userid非法,则返回{"errcode": 0,"errmsg": "invalid userlist failed","invalidlist":"usr1|usr2|usr"} c)当包含userid全部非法时返回{"errcode": 40070,"errmsg": "all list invalid "} 添加标签成员返回结果 a)正确时返回{"errcode": 0,"errmsg": "ok"} b)若部分userid非法,则返回{"errcode": 0,"errmsg": "invalid userlist failed","invalidlist":"usr1|usr2|usr"} c)当包含userid全部非法时返回{"errcode": 40070,"errmsg": "all list invalid "} 获取标签列表返回结果 多媒体文件接口 上传临时媒体文件 调用接口凭证 媒体文件类型,分别有图片(image)、语音(voice)、视频(video),普通文件(file) form-data中媒体文件标识,有filename、filelength、content-type等信息 代理请求超时时间(毫秒) 获取临时媒体文件 上传永久图文素材 上传其他类型永久素材 获取永久图文素材 获取临时媒体文件 删除永久素材 修改永久图文素材 获取素材总数 获取素材列表 上传临时媒体文件返回结果 上传永久素材返回结果 获取成员信息 调用接口凭证 通过员工授权获取到的code,每次员工授权带上的code将不一样,code只能使用一次,5分钟未被使用自动过期 权限说明:管理员须拥有agent的使用权限;agentid必须和跳转链接时所在的企业应用ID相同。 获取成员信息返回结果 员工UserID 非企业成员的OpenId 手机设备号(由微信在安装时随机生成) 只针对这个CorpId的锁 通用接口AccessToken容器,用于自动管理AccessToken,如果过期会重新获取 注册应用凭证信息,此操作只是注册,不会马上获取Token,并将清空之前的Token, 使用完整的应用凭证获取Token,如果不存在将自动注册 获取可用Token 是否强制重新获取新的Token 获取可用Token 是否强制重新获取新的Token 检查是否已经注册 使用AccessToken进行操作时,如果遇到AccessToken错误的情况,重新获取AccessToken一次,并重试 第一个参数为accessToken 通用基础API 获取AccessToken 获取微信服务器的ip段 获取调用微信JS接口的临时票据 获取应用提供商凭证 userid转换成openid接口 企业号内的成员id 需要发送红包的应用ID,若只是使用微信支付和企业转账,则无需该参数 openid转换成userid接口 创建菜单 菜单内容 代理请求超时时间(毫秒) 获取单击按钮 从JSON字符串获取菜单对象 获取当前菜单,如果菜单不存在,将返回null 调用接口凭证 企业应用的id,整型。可在应用的设置页面查看 根据微信返回的Json数据得到可用的GetMenuResult结果 删除菜单 调用接口凭证 企业应用的id,整型。可在应用的设置页面查看 向需要AccessToken的API发送消息的公共方法 这里的AccessToken是通用接口的AccessToken,非OAuth的。如果不需要,可以为null,此时urlFormat不要提供{0}参数 如果是Get方式,可以为null 向需要AccessToken的API发送消息的公共方法 这里的AccessToken是通用接口的AccessToken,非OAuth的。如果不需要,可以为null,此时urlFormat不要提供{0}参数 如果是Get方式,可以为null userid转换成openid接口返回的Json结果 企业号成员userid对应的openid,若有传参agentid,则是针对该agentid的openid。否则是针对企业号corpid的openid 应用的appid,若请求包中不包含agentid则不返回appid。该appid在使用微信红包时会用到 GetMenu返回的Json结果 获取菜单时候的完整结构,用于接收微信服务器返回的Json信息 jsapi_ticket请求后的JSON返回格式 获取到的凭证 凭证有效时间,单位:秒 获取应用提供商凭证返回格式 服务提供商的accesstoken,可用于用户授权登录信息查询接口 凭证有效时间,单位:秒 单个按键 所有单击按钮的基类(view,click等) 所有按钮基类 按钮描述,既按钮名字,不超过16个字节,子菜单不超过40个字节 按钮类型(click或view) 类型为location_select时必须。 用户点击按钮后,微信客户端将调起地理位置选择工具,完成选择操作后,将选择的地理位置发送给开发者的服务器,同时收起位置选择工具,随后可能会收到开发者下发的消息。 仅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用户,旧版本微信用户点击后将没有回应,开发者也不能正常接收到事件推送。 单个按键 类型为pic_photo_or_album时必须。 用户点击按钮后,微信客户端将弹出选择器供用户选择“拍照”或者“从手机相册选择”。用户选择后即走其他两种流程。 仅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用户,旧版本微信用户点击后将没有回应,开发者也不能正常接收到事件推送。 单个按键 类型为pic_sysphoto时必须。 用户点击按钮后,微信客户端将调起系统相机,完成拍照操作后,会将拍摄的相片发送给开发者,并推送事件给开发者,同时收起系统相机,随后可能会收到开发者下发的消息。 仅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用户,旧版本微信用户点击后将没有回应,开发者也不能正常接收到事件推送。 单个按键 类型为pic_weixin时必须。 用户点击按钮后,微信客户端将调起微信相册,完成选择操作后,将选择的相片发送给开发者的服务器,并推送事件给开发者,同时收起相册,随后可能会收到开发者下发的消息。 仅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用户,旧版本微信用户点击后将没有回应,开发者也不能正常接收到事件推送。 单个按键 类型为scancode_push时必须。 用户点击按钮后,微信客户端将调起扫一扫工具,完成扫码操作后显示扫描结果(如果是URL,将进入URL),且会将扫码的结果传给开发者,开发者可以下发消息。 仅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用户,旧版本微信用户点击后将没有回应,开发者也不能正常接收到事件推送。 单个按键 类型为scancode_waitmsg时必须。 用户点击按钮后,微信客户端将调起扫一扫工具,完成扫码操作后,将扫码的结果传给开发者,同时收起扫一扫工具,然后弹出“消息接收中”提示框,随后可能会收到开发者下发的消息。 仅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用户,旧版本微信用户点击后将没有回应,开发者也不能正常接收到事件推送。 将RequestMessageEventBase转换成RequestMessageText类型,其中Content = requestMessage.EventKey GetToken请求后的JSON返回格式 获取到的凭证 整个按钮设置(可以直接用ButtonGroup实例返回JSON对象) 按钮数组,按钮个数应为2~3个 单个按键 类型为click时必须。 按钮KEY值,用于消息接口(event类型)推送,不超过128字节 Url按键 类型为view时必须 网页链接,用户点击按钮可打开链接,不超过256字节 子菜单 子按钮数组,按钮个数应为2~5个 根据xml信息,返回RequestMsgType 根据xml信息,返回RequestMsgType 根据xml信息,返回ThirdPartyInfo 根据xml信息,返回RequestInfoType 根据xml信息,返回ResponseMsgType 根据xml信息,返回ResponseMsgType 接收人 接收人类型:single|group,分别表示:群聊|单聊 接收人的值,为userid|chatid,分别表示:成员id|会话id 具有EventKey属性的RequestMessage接口 事件类型 接收到请求的消息 企业应用的id,整型。可在应用的设置页面查看 事件类型 事件之点击推事件(Click) 事件类型 事件KEY值,与自定义菜单接口中KEY值对应 异步任务完成事件推送(batch_job_result) 事件类型 异步任务完成事件推送BatchJob 事件之弹出地理位置选择器(location_select) 事件类型 事件KEY值,与自定义菜单接口中KEY值对应 发送的位置信息 事件之弹出拍照或者相册发图(pic_photo_or_album) 事件类型 事件KEY值,与自定义菜单接口中KEY值对应 发送的图片信息 事件之弹出系统拍照发图(pic_sysphoto) 事件类型 事件KEY值,与自定义菜单接口中KEY值对应 发送的图片信息 事件之弹出微信相册发图器(pic_weixin) 事件类型 事件KEY值,与自定义菜单接口中KEY值对应 发送的图片信息 事件之扫码推事件(scancode_push) 事件类型 事件KEY值,与自定义菜单接口中KEY值对应 扫描信息 事件之扫码推事件且弹出“消息接收中”提示框(scancode_waitmsg) 事件类型 事件KEY值,与自定义菜单接口中KEY值对应 扫描信息 事件之URL跳转视图(View) 事件类型 事件KEY值,设置的跳转URL 事件之关注事件的推送(subscribe) 事件类型 事件之取消关注事件的推送(unsubscribe) 事件类型 上报地理位置事件 地理位置纬度 地理位置经度 地理位置精度 会话信息 会话id 会话标题 管理员userid 会话成员列表,成员用userid标识,成员间以竖线“|”分隔 扫码事件中的ScanCodeInfo 弹出地理位置选择器的事件推送中的SendLocationInfo X坐标信息 Y坐标信息 精度,可理解为精度或者比例尺、越精细的话 scale越高 地理位置的字符串信息 朋友圈POI的名字,可能为空 系统拍照发图中的SendPicsInfo 发送的图片数量 图片列表 图片的MD5值,开发者若需要,可用于验证接收到图片 异步任务完成事件推送的BatchJob 异步任务id,最大长度为64字符 操作类型,字符串,目前分别有: 1. sync_user(增量更新成员) 2. replace_user(全量覆盖成员) 3. invite_user(邀请成员关注) 4. replace_party(全量覆盖部门) 返回码 对返回码的文本描述内容 用户进入应用的事件推送(enter_agent) 事件类型 事件KEY值,此事件该值为空 应用套件的SuiteId 时间戳 推送suite_ticket协议 Ticket内容 变更授权的通知 授权方企业号的corpid 取消授权的通知 授权方企业号的corpid内容 微信企业号服务器Post过来的参数集合(不包括PostData) 地理位置纬度 地理位置经度 语音消息媒体id,可以调用多媒体文件下载接口拉取数据。 语音格式:amr 标题 描述 点击后跳转的链接 图文消息的图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80。如不填,在客户端不显示图片 返回给服务器的加密消息 响应回复消息 获取响应类型实例,并初始化 请求 响应类型 获取响应类型实例,并初始化 需要返回的类型 请求数据 从返回结果XML转换成IResponseMessageBase实体类 返回给服务器的Response Xml 文章列表,微信客户端只能输出前10条(可能未来数字会有变化,出于视觉效果考虑,建议控制在8条以内) 需要预先上传多媒体文件到微信服务器,只支持认证服务号。 需要预先上传多媒体文件到微信服务器,只支持认证服务号。 图文消息的标题 图文消息缩略图的media_id, 可以在上传多媒体文件接口中获得。此处thumb_media_id即上传接口返回的media_id 图文消息的作者 图文消息点击“阅读原文”之后的页面链接 图文消息的内容,支持html标签 图文消息的描述 是否显示封面,1为显示,0为不显示 文章列表,微信客户端只能输出前10条(可能未来数字会有变化,出于视觉效果考虑,建议控制在8条以内) 接收消息类型 当RequestMsgType类型为Event时,Event属性的类型 进入会话(似乎已从官方API中移除) 地理位置 订阅 取消订阅 自定义菜单点击事件 二维码扫描 URL跳转 事件推送群发结果 模板信息发送完成 扫码推事件 扫码推事件且弹出“消息接收中”提示框 弹出系统拍照发图 弹出拍照或者相册发图 弹出微信相册发图器 弹出地理位置选择器 用户进入应用的事件推送 异步任务完成事件推送 推送suite_ticket协议 变更授权的通知 取消授权的通知 发送消息类型 菜单按钮类型 点击 Url 扫码推事件 扫码推事件且弹出“消息接收中”提示框 弹出系统拍照发图 弹出拍照或者相册发图 弹出微信相册发图器 弹出地理位置选择器 上传媒体文件类型 图片: 1MB,支持JPG格式 语音:2MB,播放长度不超过60s,支持AMR格式 视频:10MB,支持MP4格式 普通文件:10MB 语言 中文简体 中文繁体 英文 群聊类型 群聊发送消息类型 免打扰状态 根据XML信息填充实实体 MessageBase为基类的类型,Response和Request都可以 实体 XML 将实体转为XML RequestMessage或ResponseMessage 实体 将实体转为XML字符串 RequestMessage或ResponseMessage 实体 ResponseMessageBase.CreateFromResponseXml(xml)的扩展方法 返回给服务器的Response Xml 设置参数值 获取随机字符串 获取时间戳 sha1加密 获取JS-SDK权限验证的签名Signature MD5UtilHelper 的摘要说明。 获取大写的MD5签名结果 签名算法 原始加密信息 上下文(仅限于当前MessageHandler基类内) 根据当前的RequestMessage创建指定类型的ResponseMessage 基于ResponseMessageBase的响应消息类型 默认返回消息(当任何OnXX消息没有被重写,都将自动返回此默认消息) 预处理文字或事件类型请求。 这个请求是一个比较特殊的请求,通常用于统一处理来自文字或菜单按钮的同一个执行逻辑, 会在执行OnTextRequest或OnEventRequest之前触发,具有以下一些特征: 1、如果返回null,则继续执行OnTextRequest或OnEventRequest 2、如果返回不为null,则终止执行OnTextRequest或OnEventRequest,返回最终ResponseMessage 3、如果是事件,则会将RequestMessageEvent自动转为RequestMessageText类型,其中RequestMessageText.Content就是RequestMessageEvent.EventKey 文字类型请求 位置类型请求 图片类型请求 语音类型请求 视频类型请求 小视频类型请求 Event事件类型请求 Event事件类型请求之CLICK 事件之URL跳转视图(View) 弹出拍照或者相册发图 扫码推事件 扫码推事件且弹出“消息接收中”提示框 弹出地理位置选择器 弹出微信相册发图器 弹出系统拍照发图 订阅 取消订阅 上报地理位置事件 用户进入应用的事件推送(enter_agent) 异步任务完成事件推送(batch_job_result) 全局消息上下文 根据ResponseMessageBase获得转换后的ResponseDocument 注意:这里每次请求都会根据当前的ResponseMessageBase生成一次,如需重用此数据,建议使用缓存或局部变量 最后返回的ResponseDocument。 这里是Senparc.Weixin.QY,应当在ResponseDocument基础上进行加密(每次获取重新加密,所以结果会不同) 应用ID 原始加密信息 请求实体 响应实体 正常情况下只有当执行Execute()方法后才可能有值。 也可以结合Cancel,提前给ResponseMessage赋值。 获取XDocument转换后的IRequestMessageBase实例。 如果MsgType不存在,抛出UnknownRequestMsgTypeException异常 获取XDocument转换后的IRequestMessageBase实例。 如果MsgType不存在,抛出UnknownRequestMsgTypeException异常 获取XDocument转换后的IRequestMessageBase实例。 如果MsgType不存在,抛出UnknownRequestMsgTypeException异常 如Request.InputStream 获取微信服务器发送过来的加密xml信息 获取XDocument转换后的IResponseMessageBase实例(通常在反向读取日志的时候用到)。 如果MsgType不存在,抛出UnknownRequestMsgTypeException异常 获取XDocument转换后的IRequestMessageBase实例。 如果MsgType不存在,抛出UnknownRequestMsgTypeException异常 在网站没有提供Token(或传入为null)的情况下的默认Token,建议在网站中进行配置。 在网站没有提供EncodingAESKey(或传入为null)的情况下的默认Token,建议在网站中进行配置。 在网站没有提供CorpId(或传入为null)的情况下的默认Token,建议在网站中进行配置。 获取签名 检查签名 签名串,对应URL参数的msg_signature 时间戳,对应URL参数的timestamp 随机串,对应URL参数的nonce 随机串,对应URL参数的echostr 加密消息 解密方法 密文 将数字转化成ASCII码对应的字符,用于对明文进行补码 @param a 需要转化的数字 @return 转化得到的字符 密钥 请求的参数 debug信息 初始化函数 获取debug信息 获取密钥 设置密钥 设置参数值 创建md5摘要,规则是:按参数名称a-z排序,遇到空值的参数不参加签名 参数名 参数值 key和value通常用于填充最后一组参数 输出XML 设置debug信息 '============================================================================ 'Api说明: 'GetKey()/setKey(),获取/设置密钥 'GetParameter()/setParameter(),获取/设置参数值 'GetAllParameters(),获取所有参数 'IsTenpaySign(),是否正确的签名,true:是 false:否 'IsWXsign(),是否正确的签名,true:是 false:否 ' * IsWXsignfeedback判断微信维权签名 ' *GetDebugInfo(),获取debug信息 '============================================================================ 密钥 appkey xmlMap 应答的参数 debug信息 原始内容 初始化函数 获取页面提交的get和post参数 获取密钥 设置密钥 获取参数值 设置参数值 是否财付通签名,规则是:按参数名称a-z排序,遇到空值的参数不参加签名。return boolean 获取debug信息 设置debug信息 输出XML 微信支付基础信息储存类 第三方用户唯一凭证appid 第三方用户唯一凭证密钥,即appsecret 商户ID 商户支付密钥Key。登录微信商户后台,进入栏目【账户设置】【密码安全】【API 安全】【API 密钥】 支付完成后的回调处理页面 微信支付信息集合,Key为商户号(MchId) 微信支付信息集合,Key为商户号(MchId) 注册TenPayInfo信息 TenpayUtil 的摘要说明。 配置文件 随机生成Noncestr 对字符串进行URL编码 对字符串进行URL解码 取时间戳生成随即数,替换交易单号中的后10位流水号 取随机数 企业号微信支付接口 用于企业向微信用户个人付款 目前支持向指定微信用户的openid付款 微信支付需要post的xml数据 用于商户的企业付款操作进行结果查询,返回付款操作详细结果。