配置请求地址

功能简介

请求地址用于接收开放平台向应用推送的事件消息。当应用订阅的事件发生时，开放平台会向该请求地址发送相应的 HTTP POST 请求。

注意：

每个应用只能配置一个请求地址，该应用订阅的所有事件都会发送到该请求地址。

请求地址必须是公网 IP 地址。

在消息卡片功能中，如果需要功能交互，也需要配置消息卡片请求网址。有关消息卡片请求网址的详细介绍，请参考消息卡片介绍。

操作方式

Step 1：配置验证请求的响应方式

在开发者后台，配置请求地址后，开放平台会向请求地址推送一个 application/json 格式的 POST 请求，该 POST 请求用于验证所配置的请求地址的合法性。该 POST 请求中会携带一个 challenge 字段，应用需要在 1 秒内，将接收到的 challenge 值原样返回给飞书开放平台。

根据 Encrypt Key 的配置情况，推送的 POST 请求不同，应用的处理方式也不同。

未配置 Encrypt Key

如果没有设置 Encrypt Key，飞书开放平台会推送明文的 POST 请求：

{ 
    "challenge": "ajls384kdjx98XX", // 应用需要在响应中原样返回的值 
    "token": "xxxxxx",              // 即 Verification Token
    "type": "url_verification"      // 表示这是一个验证请求 
}

当请求地址收到开放平台推送的 POST 验证请求时，需要解析出 challenge 值，并在 1 秒内原样返回该该值作为响应。

{ 
    "challenge": "ajls384kdjx98XX"
}

已配置 Encrypt Key

如果配置了 Encrypt Key，飞书开放平台会推送加密后的 POST 请求。

{
    "encrypt": "ds3da3sj32421lkkld4s5ao" // 加密字符串
}

应用需要先解密，然后从解密后的内容中提取出 challenge 值，并在 1 秒内原样返回该值作为响应。有关解密方法的详细介绍，请参考接收并处理事件。

解密后的 POST 请求示例：

{ 
    "challenge": "ajls384kdjx98XX", // 应用需要在响应中原样返回的值 
    "token": "xxxxxx",              // 即 Verification Token
    "type": "url_verification"      // 表示这是一个验证请求 
}

响应示例：

{ 
    "challenge": "ajls384kdjx98XX"
}

Step 2：配置请求地址

登录开发者后台。

在应用列表中点击具体应用，进入应用管理详情页面。

进入 事件订阅 页面。定位到 请求地址配置 区域，点击编辑按钮。

输入请求地址后，点击保存。

点击保存后，飞书开放平台便会向请求地址发送一个 POST 请求，验证请求地址的合法性。

功能简介#

操作方式#

Step 1：配置验证请求的响应方式#

未配置 Encrypt Key#

已配置 Encrypt Key#