小紅書廣告推廣表單API對接指南

1. 對接步驟

第一步：在落地頁的數(shù)據(jù)推送功能中設(shè)置一個有效的POST消息接收地址。

第二步：發(fā)送測試消息進行聯(lián)調(diào)測試，確保響應(yīng)碼為200表示聯(lián)調(diào)成功。

第三步：使用測試成功的落地頁進行廣告投放，API將實時回傳表單數(shù)據(jù)。

2. 平臺功能截圖

https://21491542.s21i.faiusr.com/4/ABUIABAEGAAgg-KIwk.png

3. 消息發(fā)送機制

當(dāng)用戶在小紅書廣告推廣中提交表單后，系統(tǒng)會將用戶信息以POST請求的形式，通過JSON格式發(fā)送到您在落地頁配置中設(shè)置的消息接收地址。若響應(yīng)碼為200，則視為推送成功。若推送失敗，系統(tǒng)會在30秒后重試，Zui多重試3次。

地址格式要求：必須是對外開放的、能夠接收POST請求的HTTP服務(wù)URL。

示例地址：https://example.com/leads

4. 簽名驗證（可選）

為了驗證消息來源的安全性，您可以對POST數(shù)據(jù)進行安全認(rèn)證。

驗證步驟：

1. 解析POST消息頭部的X-Red-Signature參數(shù)。

2. 獲取POST消息的請求體（原始body數(shù)據(jù)）。

3. 使用在落地頁配置頁面獲取的token作為secretKey，與body數(shù)據(jù)生成簽名，并與頭部的signature進行比對。

示例代碼：提供Java和Python的示例代碼。

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

簽名驗證示例（Java）：展示如何進行簽名驗證的示例代碼。

5. 有效表單回傳API對接

若客戶在落地頁數(shù)據(jù)推送功能處填寫了有效的POST消息接收地址，用戶提交的表單數(shù)據(jù)將通過小紅書廣告推廣表單數(shù)據(jù)API回傳給客戶。有效表單是指用戶通過廣告點擊后，在落地頁留資，并通過電話、微信等形式回訪確認(rèn)轉(zhuǎn)化意向的表單。

操作流程：

1. 在落地頁數(shù)據(jù)推送功能處填寫有效的POST消息接收地址。

2. 發(fā)送測試消息進行聯(lián)調(diào)測試，確保響應(yīng)碼為200。

3. 使用測試成功的落地頁進行投放，API將實時回傳表單數(shù)據(jù)。

4. 接口回傳的表單數(shù)據(jù)默認(rèn)為有效表單。

接口說明：

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

請求方法：POST

請求頭：Content-Type:application/json

參數(shù)解釋：

https://21491542.s21i.faiusr.com/4/ABUIABAEGAAgw-KIQI.png

請求示例：

bashcurl -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'

正確返回：

json{ "result": 0, "success": true, "msg": "success"