小红书广告推广表单API 对接

1. 表单数据 API 对接文档

1.1 对接流程

第一步：在落地页-数据推送功能处填写有效的POST消息接收地址
第二步：发送测试消息进行联调测试（response code必须为200才可联调成功）
第三步：使用联调成功的落地页进行投放，API实时回传表单数据

1.2 平台功能截图

1.3 消息发送

小红书广告推广当用户提交表单时，会将信息以 POST请求的方式，JSON数据格式推送到在落地页配置页面中填写的消息接收地址。对于responsecode为200即认为推送成功，对于推送失败的情况，会每隔 30s重试一次，Zui多重试 3 次。

地址格式要求：对外开放的，可接受PSOST请求的http服务URL

e.g. http://example.com/leads

1.4 签名验证

为了确保消息来源是小红书，可以选择对POST数据的来源进行安全认证（非必须），验证方法如下：

●解析POST消息header中的X-Red-Signature参数（格式为sha1=5bf9f4192d049dfe442edbcd533223673bb188e4）

● 解析POST 消息的request body（未经反序列化的原始body数据）

●以落地页配置页面获取的token为secretKey，和body数据生成签名，与header中的signature进行校验

Java示例代码：Java示例代码

Python示例代码：Python示例代码

推送消息示例：直接提供代码示例，包含姓名，电话，邮箱，性别，地址，单选，多选，文本，数值等类型的代码示例  推送消息示例

签名验证 demo（Java）：签名验证

2. 有效表单回传 API 对接文档

目前，若客户在落地页-数据推送功能处填写了有效的POST消息接收地址，则用户提交的表单数据会通过小红书广告推广表单数据API回传给客户。有效表单是指，用户通过广告点击，跳转建站落地页后进行留资，客户收到线索后通过电话、微信等形式回访用户，确认用户转化意向的，当做有效表单。本API解决的是有效表单回传的问题。

2.1 操作流程

1) 小红书广告推广在落地页 - 数据推送功能处填写有效的 POST 消息接收地址

2) 发送测试消息进行联调测试（response code 必须为 200 才可联调成功）

3) 使用联调成功的落地页进行投放，API 实时回传表单数据

4) 通过接口回传表单相关数据，回传的表单数据会默认为有效表单

2.2 接口说明

请求地址：https://www.xiaohongshu.com/api/hawking/leads/return

请求方法：POST

请求头：Content-Type:application/json

2.3参数解释

2.4 请求示例

curl -X POST --header 'Content-Type: application/json' --header'Accept: text/json' -d '{

"campaignId": 1834295,

"creativityId": 9725765,

"leadsId": "61935e4f2e299c0001fea6e8",

"unitId": 2244696

}' 'https://www.xiaohongshu.com/api/hawking/leads/return'


正确返回：

{

"result": 0,

"success": true,

"msg": "success"

}