1. 表單數(shù)據(jù) API 對(duì)接文檔

1.1 對(duì)接流程

第一步：在落地頁(yè)-數(shù)據(jù)推送功能處填寫(xiě)有效的POST消息接收地址
第二步：發(fā)送測(cè)試消息進(jìn)行聯(lián)調(diào)測(cè)試（response code必須為200才可聯(lián)調(diào)成功）
第三步：使用聯(lián)調(diào)成功的落地頁(yè)進(jìn)行投放，API實(shí)時(shí)回傳表單數(shù)據(jù)

1.2 平臺(tái)功能截圖

1.3 消息發(fā)送

地址格式要求：對(duì)外開(kāi)放的，可接受PSOST請(qǐng)求的http服務(wù)URL

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

1.4 簽名驗(yàn)證

為了確保消息來(lái)源是小紅書(shū)，可以選擇對(duì)POST數(shù)據(jù)的來(lái)源進(jìn)行安全認(rèn)證（非必須），驗(yàn)證方法如下：

● 解析POST消息header中的X-Red-Signature參數(shù)（格式為sha1=5bf9f4192d049dfe442edbcd533223673bb188e4）

● 解析POST 消息的request body（未經(jīng)反序列化的原始body數(shù)據(jù)）

● 以落地頁(yè)配置頁(yè)面獲取的token為secretKey，和body數(shù)據(jù)生成簽名，與header中的signature進(jìn)行校驗(yàn)

Java示例代碼：Java示例代碼

Python示例代碼：Python示例代碼

推送消息示例：直接提供代碼示例，包含姓名，電話，郵箱，性別，地址，單選，多選，文本，數(shù)值等類型的代碼示例   推送消息示例

簽名驗(yàn)證 demo（Java）：簽名驗(yàn)證

2. 有效表單回傳 API 對(duì)接文檔

目前，若客戶在落地頁(yè)-數(shù)據(jù)推送功能處填寫(xiě)了有效的POST消息接收地址，則用戶提交的表單數(shù)據(jù)會(huì)通過(guò)小紅書(shū)廣告推廣表單數(shù)據(jù)API回傳給客戶。有效表單是指，用戶通過(guò)廣告點(diǎn)擊，跳轉(zhuǎn)建站落地頁(yè)后進(jìn)行留資，客戶收到線索后通過(guò)電話、微信等形式回訪用戶，確認(rèn)用戶轉(zhuǎn)化意向的，當(dāng)做有效表單。本API解決的是有效表單回傳的問(wèn)題。

2.1 操作流程

1) 小紅書(shū)廣告推廣在落地頁(yè) - 數(shù)據(jù)推送功能處填寫(xiě)有效的 POST 消息接收地址

2) 發(fā)送測(cè)試消息進(jìn)行聯(lián)調(diào)測(cè)試（response code 必須為 200 才可聯(lián)調(diào)成功）

3) 使用聯(lián)調(diào)成功的落地頁(yè)進(jìn)行投放，API 實(shí)時(shí)回傳表單數(shù)據(jù)

4) 通過(guò)接口回傳表單相關(guān)數(shù)據(jù)，回傳的表單數(shù)據(jù)會(huì)默認(rèn)為有效表單

2.2 接口說(shuō)明

請(qǐng)求地址：https://www.xiaohongshu.com/api/hawking/leads/return

請(qǐng)求方法：POST

請(qǐng)求頭：Content-Type:application/json

2.3 參數(shù)解釋

2.4 請(qǐng)求示例