Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
企业内部开发智慧硬件开发
第三方应用开发
企业内部开发智慧硬件开发
第三方应用开发
  1. 概述
  • 开发指南
    • 回调配置
      • 虚拟业务信息查询接口
    • 获取服务商凭证
      POST
  • 消息推送
    • 接收消息与事件
      • 概述
        • 概述-验证URL有效性
          GET
        • 概述-获取企业微信服务器的ip段
          GET
        • 概述-使用接收消息
          POST
    • 发送应用消息
      POST
    • 更新模版卡片消息
      POST
  • 通讯录管理
    • 成员管理
      • 创建成员
      • 读取成员
      • 更新成员
      • 删除成员
      • 批量删除成员
      • 获取部门成员
      • 获取部门成员详情
      • userid与openid互换-userid转openid
      • userid与openid互换-openid转userid
      • 二次验证
      • 邀请成员
    • 部门管理
      • 创建部门
      • 更新部门
      • 删除部门
      • 获取部门列表
    • 标签管理
      • 创建标签
      • 更新标签名字
      • 删除标签
      • 获取标签成员
      • 增加标签成员
      • 删除标签成员
      • 获取标签列表
    • 异步批量接口
      • 增量更新成员
      • 全量覆盖成员
      • 全量覆盖部门
      • 获取异步任务结果
  • 应用管理
    • 获取应用-获取指定的应用详情
      GET
    • 获取应用-获取access_token对应的应用列表
      GET
  • 素材管理
    • 上传临时素材
      POST
    • 上传图片
      POST
    • 获取临时素材
      GET
    • 获取高清语音素材
      GET
  • OA数据接口
    • 审批流程引擎
      POST
  • 电子发票
    • 查询电子发票
      POST
    • 更新发票状态
      POST
    • 批量更新发票状态
      POST
    • 批量查询电子发票
      POST
  • 推广二维码
    • 回调通知
      • 注册完成回调事件
    • 调用接口
      • 获取注册码
      • 查询注册状态
      • 设置授权应用可见范围
      • 设置通讯录同步完成
  • 应用授权
    • 接口调用
      • 获取第三方应用凭证
      • 获取预授权码
      • 设置授权配置
      • 获取企业永久授权码
      • 获取企业授权信息
      • 获取企业凭证
      • 获取应用的管理员列表
    • 回调接口
      • 标签通知事件 标签成员变更事件
  • 身份验证
    • 网页授权登录
      • 获取访问用户身份
      • 获取访问用户敏感信息
    • 扫码授权登录
      • 获取登录用户信息
  • 设备管理
    • 接口调用
      • 添加设备实例
      • 查询设备绑定信息
      • 重置设备SecretNo
      • 获取设备列表
      • 上传设备日志
      • 获取设备自定义参数
      • 删除设备实例
      • 设置打印机支持状态
  1. 概述

概述-验证URL有效性

GET
http://127.0.0.1/
智慧硬件开发/消息推送/接收消息与事件/概述
最后修改时间:2022-08-30 03:03:37
责任人:未设置
当点击“保存”提交以上信息时,企业微信会发送一条验证消息到填写的URL,发送方法为GET。
企业的接收消息服务器接收到验证请求后,需要作出正确的响应才能通过URL验证。
企业在获取请求时需要做Urldecode处理,否则可能会验证不成功
你可以访问接口调试工具进行调试,依次选择 建立连接 > 接收消息。
假设接收消息地址设置为:http://api.3dept.com/,企业微信将向该地址发送如下验证请求:
企业后台收到请求后,需要做如下操作:
1.
对收到的请求做Urldecode处理
2.
通过参数msg_signature对请求进行校验,确认调用者的合法性。
3.
解密echostr参数得到消息内容(即msg字段)
4.
在1秒内响应GET请求,响应内容为上一步得到的明文消息内容(不能加引号,不能带bom头,不能带换行符)
以上2~3步骤可以直接使用验证URL函数一步到位。
之后接入验证生效,接收消息开启成功
文档ID: 12977
原文档地址:
https://open.work.weixin.qq.com/api/doc/90000/90135/90238

请求参数

Query 参数
msg_signature
string 
必需
企业微信加密签名,msg_signature计算结合了企业填写的token、请求中的timestamp、nonce、加密的消息体。签名计算方法参考 消息体签名检验
示例值:
ASDFQWEXZCVAQFASDFASDFSS
timestamp
string 
必需
时间戳。与nonce结合使用,用于防止请求重放攻击。
示例值:
13500001234
nonce
string 
必需
随机数。与timestamp结合使用,用于防止请求重放攻击。
示例值:
123412323
echostr
string 
必需
加密的字符串。需要解密得到消息内容明文,解密后有random、msg_len、msg、receiveid四个字段,其中msg即为消息内容明文
示例值:
ENCRYPT_STR

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1/?msg_signature=ASDFQWEXZCVAQFASDFASDFSS&timestamp=13500001234&nonce=123412323&echostr=ENCRYPT_STR'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
修改于 2022-08-30 03:03:37
上一页
获取服务商凭证
下一页
概述-获取企业微信服务器的ip段
Built with