小红书广告推广表单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. https://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"
}