小红书广告推广表单API 对接
小红书广告推广表单API 对接
1. 表单数据 API 对接文档
1.1 对接流程
第一步：在落地页-数据推送功能处填写有效的POST消息接收地址
第二步：发送测试消息进行联调测试（response code必须为200才可联调成功）
第三步：使用联调成功的落地页进行投放，API实时回传表单数据
1.2 平台功能截图
1.3 消息发送
小红书广告推广当用户提交表单时，会将信息以 POST 请求的方式，JSON数据格式推送到在落地页配置页面中填写的消息接收地址。对于response code为200即认为推送成功，对于推送失败的情况，会每隔 30s重试一次，最多重试 3 次。
地址格式要求：对外开放的，可接受PSOST请求的http服务URL
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"
}