概述-验证URL有效性

GET

http://127.0.0.1/

智慧硬件开发/消息推送/接收消息与事件/概述

最后修改时间：2022-08-30 03:03:37

责任人：未设置

当点击“保存”提交以上信息时，企业微信会发送一条验证消息到填写的URL，发送方法为GET。
企业的接收消息服务器接收到验证请求后，需要作出正确的响应才能通过URL验证。

企业在获取请求时需要做Urldecode处理，否则可能会验证不成功
你可以访问接口调试工具进行调试，依次选择建立连接 > 接收消息。

假设接收消息地址设置为：http://api.3dept.com/，企业微信将向该地址发送如下验证请求：

企业后台收到请求后，需要做如下操作：

对收到的请求做Urldecode处理

通过参数msg_signature对请求进行校验，确认调用者的合法性。

解密echostr参数得到消息内容(即msg字段)

在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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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}

示例

{}

获取服务商凭证

概述-获取企业微信服务器的ip段