內(nèi)容設(shè)計(jì)
該接口由第三方開發(fā)者提供給人人秀調(diào)用，使用第三?發(fā)獎接口，可以豐富獎品的領(lǐng)取方式。實(shí)現(xiàn)領(lǐng)獎?信息通過第三?接口傳遞給第三方開發(fā)者。
請求地址 | [第三方發(fā)獎] | |
請求方式 | POST | |
參數(shù)說明 | ||
參數(shù)名稱 | 是否必須 | 說明 |
app_key | 是 | 人人秀平臺分配的AppKey |
time_stamp | 是 | 1970-01-01開始的時間戳，精確到毫秒 |
sign | 是 | 根據(jù)簽名算法計(jì)算所得，如何計(jì)算簽名 |
openid | 是 | 活動用戶唯一標(biāo)識 |
nickname | 否 | 用戶昵稱 |
headimgurl | 否 | 用戶頭像地址 |
order_no | 是 | 人人秀訂單號 ， 當(dāng)request_type字段值為NEED_CHECK時，order_no為空 |
prize_code | 是 | 獎品標(biāo)識碼（用于開發(fā)者識別要發(fā)放的獎品） |
request_type | 是 | CHECK_PRIZE：表示當(dāng)前請求為校驗(yàn)用戶是否有領(lǐng)取獎品資格， 不進(jìn)行獎品發(fā)放。此時order_no、phone和contacts字段均為空。 開發(fā)者可以通過openid進(jìn)行資格校驗(yàn)，如果校驗(yàn)失敗返回失敗原因。 SEND_PRIZE：表示當(dāng)前為獎品發(fā)放請求。 |
phone | 否 | 該字段提取contacts里的手機(jī)號， 只有在contacts里有手機(jī)號時才有值,方便開發(fā)者通過手機(jī)號發(fā)獎 |
contacts | 否 | 該字段為用戶領(lǐng)取獎品時填寫的領(lǐng)獎信息。 該字段為JSON數(shù)組字符串 [{"id":"1","name":"姓名","value":"zcho"}, {"id":"3","name":"手機(jī)","value":"13635603333"}] |
| h5_guid | 否 | 活動GUID |
響應(yīng)參數(shù) | ||
參數(shù) | 是否必須 | 參數(shù)說明 |
result | 是 | 0：成功 1：失敗 |
msg | 否 | result為1時，返回錯誤原因 |
data | 否 | result為0時，返回的第三方獎品展示信息 |
響應(yīng)示例 | ||
成功 | {"result":0,"msg":"","data":[{"name":"名稱","value":"名稱值"}]} | |
失敗 | {"result":1,"msg":"沒有領(lǐng)獎資格"} | |
第一步，對接收的參數(shù)進(jìn)行urldecode處理
第二步，計(jì)算簽名和驗(yàn)證簽名
第三步，返回處理結(jié)果，返回值必須是json格式
注意：
1 第三方開發(fā)者，接收到參數(shù)，必須先將參數(shù)urldecode處理，然后計(jì)算簽名
2 contacts 參數(shù)類型是json字符串
如果要在頁面顯示contacts 的內(nèi)容，需要第三方開發(fā)者自己將json字符串轉(zhuǎn)為對象
第三方獎品庫
請求地址 | 由第三方平臺提供 | |
請求方式 | POST | |
參數(shù)名稱 | 是否必須 | 說明 |
app_key | 是 | 人人秀平臺分配的AppKey |
time_stamp | 是 | 1970-01-01開始的時間戳，精確到毫秒 |
sign | 是 | 根據(jù)簽名算法所得，如何計(jì)算簽名 |
page | 是 | 第幾頁數(shù)據(jù) |
limit | 是 | 每頁多少條數(shù)據(jù) |
返回JSON格式結(jié)果 | ||
{"result":0,"msg":"","data":{}} | ||
參數(shù)名稱 | 說明 | |
result | 0表示成功，1表示失敗 | |
msg | 表示失敗詳細(xì)描述 | |
data | 成功時，返回獎品數(shù)據(jù) | |
data參數(shù)說明
參數(shù)名稱 | 是否必須 | 說明 |
total | 是 | 數(shù)據(jù)總筆數(shù) |
rows | 是 | 數(shù)據(jù)列表 |
rows參數(shù)說明
參數(shù)名稱 | 是否必須 | 說明 |
prize_name | 是 | 獎品名稱 |
prize_code | 是 | 獎品標(biāo)識 |
第一步，對接收的參數(shù)進(jìn)行urldecode處理
第二步，計(jì)算簽名和驗(yàn)證簽名
第三步，返回處理結(jié)果，返回值必須是json格式
結(jié)果示例
{
"result": 0,
"msg": "",
"data": {
"total": 3,
"rows": [{
"prize_name": "毛巾",
"prize_code": "1001"
}]
}
}
注意：
1 第三方開發(fā)者，接收到參數(shù)，必須先將參數(shù)urldecode處理，然后計(jì)算簽名
附錄：
