內容設計
接口功能說明
該接口由第三方開發(fā)者提供給人人秀調用，適用于抽獎活動。
由第三方實現抽獎邏輯，判斷用戶是否具有抽獎權限，或者用于用戶中什么獎品即指定用戶中獎。
接口參數說明
請求地址 | 由第三方平臺提供 | |
請求方式 | POST方式，Content-type：application/x-www-form-urlencoded | |
參數名稱 | 是否必須 | 說明 |
app_key | 是 | 人人秀平臺分配的AppKey |
time_stamp | 是 | 1970-01-01開始的時間戳，精確到毫秒 |
sign | 是 | 根據簽名算法所得，如何計算簽名 |
activity_guid | 是 | 活動guid，如何獲取互動ID |
h5_guid | 否 | H5活動guid |
openid | 是 | 用戶的openid |
contacts | 是 | 當前用戶報名填寫的信息 [{"id":100,"title":"姓名","value":""},{"id":300,"title":"手機號","value":"15168372166"}] |
activity_prize | 是 | 當前活動的獎品列表 [{"product_id":"18083","product_name":"商品1","product_type":"1","stock_qty":1}] 數據名稱：獎品ID、獎品名稱、獎品類型、獎品剩余數量 product_type枚舉：1：實物；2：紅包；5：優(yōu)惠券；6：積分；7：自有獎品；8：禮品 |
返回JSON格式結果 Content-type: application/json | ||
{"result":0,"msg":"","data":{}} | ||
參數名稱 | 說明 | |
result | 0表示成功，1表示失敗 | |
msg | 表示失敗詳細描述 | |
data | 成功時，返回對應數據 | |
data參數說明
參數名稱 | 是否必須 | 說明 |
win_type | 是 | 抽獎類型，1：指定用戶中獎，2：人人秀系統抽獎 |
product_id | 是 | 指定的獎品id （從接口返回的活動獎品列表中獲?。?當win_type=1時必填 product_id=0時，表示用戶不中獎 |
請求示例
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"activity_guid ":"0e73db7048aadef7203831c904754dc9",
"h5_guid":"123456",
"openid":"gb_1543999047492",
"contacts":[
{
"id":100,
"title":"姓名",
"value":"張三"
},
{
"id":200,
"title":"手機號",
"value":"1581111111"
}
],
"activity_prize":[
{
"product_id":10001,
"product_name":"商品1",
"product_type":"1",
"stock_qty":1
}
]
}
返回值必須是json格式 Content-type: application/json
{
"result": 0,
"data": {
"win_type": "1",
"product_id": "10001",
},
"msg": "ok"
}
相關文檔
