抽獎(jiǎng)活動(dòng)API

• 獲取參與抽獎(jiǎng)名單
• 分頁(yè)獲取參與抽獎(jiǎng)名單
• 導(dǎo)出參與名單的報(bào)表模板
• 導(dǎo)入?yún)⑴c名單
• 內(nèi)定中獎(jiǎng)名單列表
• 獲取待添加到內(nèi)定名單的列表
• 添加內(nèi)定中獎(jiǎng)人
• 修改內(nèi)定中獎(jiǎng)人的關(guān)聯(lián)獎(jiǎng)項(xiàng)
• 獎(jiǎng)項(xiàng)列表
• 刪除參與抽獎(jiǎng)成員
• 刪除內(nèi)定中獎(jiǎng)成員

提供給機(jī)構(gòu)管理后臺(tái)接口

新建活動(dòng)

API

[POST] /api/v3/activitys

請(qǐng)求參數(shù)

Awards:
[
{
"prize_name": "獎(jiǎng)項(xiàng)名稱",
"prize_desc": "獎(jiǎng)品描述",
"prize_picture": "獎(jiǎng)品圖片鏈接",
"number": "抽中人數(shù)"
},
{
"prize_name": "獎(jiǎng)項(xiàng)名稱",
"prize_desc": "獎(jiǎng)品描述",
"prize_picture": "獎(jiǎng)品圖片鏈接",
"number": "抽中人數(shù)"
}
]

返回參數(shù)

code值含義：

{
  0：請(qǐng)求成功
  601：操作失敗
  40010：會(huì)員已經(jīng)存在
}

Sample

[POST] http://localhost:9999/api/v3/activitys?access_token=xxx&access_type=org

Body:

{
  "activity_name": "抽獎(jiǎng)1",
  "background": "http://pic2.cxtuku.com/00/02/31/b945758fd74d.jpg”,
  "logo":"",
  "music": "",
  "activity_desc": "天商未來回饋粉絲的抽獎(jiǎng)活動(dòng)",
  "permission": "",
  "collect_info": "name,phone",
  "barcode": "鏈接",
  "agency_id": "非空",
  "awards": []
}

Return:

{
  "code": 0,
  "msg": "創(chuàng)建成功",
  "data": “1”
}

查詢活動(dòng)內(nèi)容

API

[GET] /api/v3/activitys/{id}

請(qǐng)求參數(shù)

返回參數(shù)

Data:

Awards:
[
{
“prize_name”: "獎(jiǎng)項(xiàng)名稱",
“prize_desc”: "獎(jiǎng)品描述",
"prize_picture": "獎(jiǎng)品圖片鏈接",
"number": "抽中人數(shù)"
},
{
“prize_name”: "獎(jiǎng)項(xiàng)名稱",
“prize_desc”: "獎(jiǎng)品描述",
"prize_picture": "獎(jiǎng)品圖片鏈接",
"number": "抽中人數(shù)"
},
]

code值含義：

{
  0：請(qǐng)求成功
  601：操作失敗
  404：沒有找到
  40010：會(huì)員已經(jīng)存在
}

Sample

[GET] http://localhost:9999/api/v3/activitys/1?access_token=xxx&access_type=org

Return:

{
  "code": 0,
  "msg": “查詢成功",
  "data": {
          暫略
     }
}

更新活動(dòng)內(nèi)容

API

[PUT] /api/v3/activitys/{id}

請(qǐng)求參數(shù)

Awards:
[
{
"id":"獎(jiǎng)項(xiàng)id",
“prize_name”: "獎(jiǎng)項(xiàng)名稱",
“prize_desc”: "獎(jiǎng)品描述",
"prize_picture": "獎(jiǎng)品圖片鏈接",
"number": "抽中人數(shù)"
},
{
“prize_name”: "獎(jiǎng)項(xiàng)名稱",
“prize_desc”: "獎(jiǎng)品描述",
"prize_picture": "獎(jiǎng)品圖片鏈接",
"number": "抽中人數(shù)"
},
]

返回參數(shù)

Sample

[PUT] http://localhost:9999/api/v3/activitys/1?access_token=xxx&access_type=org

Body:

{
  "activity_name": “抽獎(jiǎng)1”,
  "background": "http://pic2.cxtuku.com/00/02/31/b945758fd74d.jpg”,
  "logo": “”,
  “music”: "",
  “activity_desc”: “天商未來回饋粉絲的抽獎(jiǎng)活動(dòng)”,
  “permission: "",
  “collect_info”: ”name,phone“,
  “barcode”: “鏈接”，
  “awards":[]
}

Return:

{
  "code": 0,
  "msg": "更新成功",
  "data": “1”
}

刪除活動(dòng)

API

[DELETE] /api/v3/activitys/{id}

請(qǐng)求參數(shù)

返回參數(shù)

Sample

[DELETE] http://localhost:9999/api/activitys/{id}?access_token=xxx&access_type=org

Return:

{
  "code": 0,
  "msg": “刪除活動(dòng)成功”,
  "data”:1
}

獲取機(jī)構(gòu)所有活動(dòng)列表

API

[GET] /api/v3/activitys

請(qǐng)求參數(shù)

返回參數(shù)

Data:

Sample

[GET] http://localhost:9999/api/v3/activity?access_token=xxx&access_type=org&agency_id=1

Return:

{
  "code": 0,
  "msg": “獲取活動(dòng)列表成功",
  "data": [
        {
          "id":1,
          "activity_name":"lottery1",
          "background":"xxxx",
          "logo":"xxxx",
          "join_count": 10
       },      
        {
          "id":2,
          "activity_name":"lottery2",
          "background":"xxxx",
          "logo":"xxxx",
          "join_count": 10
       },               
}

獲取中獎(jiǎng)名單

API

[GET] /api/v3/activitys/{id}/win_lottery

請(qǐng)求參數(shù)

返回參數(shù)

Sample

[GET] http://localhost:9999/api/v3/activitys/1/win_lottery?access_token=xxx&access_type=org

Return:

{
  "code": 0,
  "msg": “獲取中獎(jiǎng)名單成功",
  "data": {}
}

Data:

分頁(yè)獲取中獎(jiǎng)名單

API

[GET] /api/v3/activitys/{id}/win_lottery_partition

請(qǐng)求參數(shù)

返回參數(shù)

Sample

[GET] http://localhost:9999/api/v3/activitys/1/win_lottery_partition?access_token=xxx&access_type=org&page_size=10&page_index=1

Return:

{
  "code": 0,
  "msg": “讀取成功",
  "data": {
      "total":10
      "current_page":[]
}
}

current_page的數(shù)據(jù)項(xiàng):

獲取參與抽獎(jiǎng)名單

API

[GET] /api/v3/activitys/{id}/join_lottery

請(qǐng)求參數(shù)

返回參數(shù)

<span id="join_list"></span>
data數(shù)組數(shù)據(jù)項(xiàng)格式:

join_status:

{
  0:未中獎(jiǎng)
  1:已中獎(jiǎng)
}

member_source:

{
  'wx':來源是微信
  'offline':線下導(dǎo)入
}

set_default_awards:

{
  'true':設(shè)置了內(nèi)定獎(jiǎng)項(xiàng)
  'false':未設(shè)置內(nèi)定獎(jiǎng)項(xiàng)
}

分頁(yè)獲取參與抽獎(jiǎng)名單

API

[GET] /api/v3/activitys/{id}/join_lottery_partition

請(qǐng)求參數(shù)

返回參數(shù)

Data:

{
      "total": 整數(shù)
      "current_page": 數(shù)組
}

current_page數(shù)組的數(shù)據(jù)項(xiàng)格式:
同獲取參與抽獎(jiǎng)名單返回的參數(shù)

join_status:

{
  0:未中獎(jiǎng)
  1:已中獎(jiǎng)
}

member_source:

{
  'wx':來源是微信
  'offline':線下導(dǎo)入
}

set_default_awards:

{
  'true':設(shè)置了內(nèi)定獎(jiǎng)項(xiàng)
  'false':未設(shè)置內(nèi)定獎(jiǎng)項(xiàng)
}

導(dǎo)出參與抽獎(jiǎng)的名單

API

[GET] /api/v3/activitys/{id}/join_lottery_export

請(qǐng)求參數(shù)

返回
excel表joinlist.xlsx

導(dǎo)出中獎(jiǎng)名單

API

[GET] /api/v3/activitys/{id}/win_lottery_export

請(qǐng)求參數(shù)

返回
excel表winlist.xlsx

設(shè)置用戶已兌獎(jiǎng)

API

[POST] /api/v3/activitys/{id}/give_awards?
access_token=xxx&access_type=org

請(qǐng)求參數(shù)

win_ids:多個(gè)中獎(jiǎng)id,用#隔開

Sample

[GET] http://localhost:9999/api/v3/activitys/1/give_awards?access_token=xxx&access_type=user

Body:

{
  "awards_ids": "1#2#3"
}

Return:

{
  "code": 0,
  "msg": "成功獲取",
  "data": 520
}

提供給微信公眾號(hào)接口

查詢授權(quán)會(huì)議

API

[GET] /api/v3/activitys/{id}/wx/auth_meeting

請(qǐng)求參數(shù)

返回參數(shù)

Sample

[GET] http://localhost:9999/api/v3/activitys/1/wx/auth_meeting?access_token=xxx&access_type=user

Return:

{
  "code": 0,
  "msg": "成功獲取",
  "data": 520
}

待收集的用戶信息

API

[GET] /api/v3/activitys/{id}/wx/collect_info

請(qǐng)求參數(shù)

返回參數(shù)

Sample

[GET] http://localhost:9999/api/v3/activitys/1/wx/collect_info?access_token=xxx&access_type=org

Return:

{
  "code": 0,
  "msg": "成功獲取",
  "data": "phone,name"
}

查詢活動(dòng)成員中獎(jiǎng)信息

API

[GET] /api/v3/activitys/{id}/wx/member/:member_id/award_info

請(qǐng)求參數(shù)

返回參數(shù)

Data:

Sample

[GET] http://localhost:9999/api/v3/activitys/2/wx/awards/2/member/2?access_token=xxx&access_type=org

Return:

{
  "code": 0,
  "msg": "查詢活動(dòng)成員中獎(jiǎng)信息成功",
  "data": {
    "status": "1",
    "activity_name": "xxxx",
    "create_time": 20170220205602,
    "nickname": "520too",
    "icon": "xxx",
    "real_name": "xxx",
    "phone": "13800138000",
    "prize_name": "獎(jiǎng)項(xiàng)名稱1",
    "prize_desc": "獎(jiǎng)品描述",
    "prize_picture": "獎(jiǎng)品圖片鏈接",
    "close_time": 20170220205602
  }
}

查詢是否已經(jīng)參與抽獎(jiǎng)

API

[GET] /api/v3/activitys/{id}/wx/hasJoin/{member_id}

請(qǐng)求參數(shù)

返回參數(shù)

Sample

[GET] http://localhost:9999/api/v3/activitys/2/wx/hasJoin?access_token=xxx&access_type=org

Return:

{
  "code": 0,
  "msg": "成功獲取",
  "data": 1
}

上傳用戶微信頭像URL和昵稱

API

[POST] /api/v3/activitys/{id}/wx/userInfo

請(qǐng)求參數(shù)

返回參數(shù)

Sample

[POST] http://localhost:9999/api/v3/activitys/1/wx/userInfo?access_token=xxx&access_type=org

Body:

{
  "member_icon": "xxx",
  "member_nickname": "abc”,
  "member_id": “xxxx”
}

Return:

{
  "code": 0,
  "msg": "提交用戶微信信息成功",
  "data": "xxxx"
}

中獎(jiǎng)反饋（服務(wù)器=>公眾號(hào)，再由公眾號(hào)推給微信用戶）

API

[POST] /api/v3/activitys/feedback

請(qǐng)求參數(shù)

返回參數(shù)

Sample

[POST] http://localhost:9999/api/v3/activity/feedback?access_token=xxx&access_type=user&member_id&info

Body:

{
  "member_id": "xxx",
  "info": "xxxx”,
  "activity_id":2,
  "awards_id":1
}

Return:

{
  "code": 0,
  "msg": "反饋成功",
  "data":"xxxx",
}

提供給活動(dòng)頁(yè)面的接口

獲取活動(dòng)頁(yè)面信息（二維碼，獎(jiǎng)項(xiàng)析砸，背景圖片，背景音樂）

API

[GET] /api/v3/activitys/{id}/page

請(qǐng)求參數(shù)

返回參數(shù)

Data:

Awards:
[
{
“prize_name”: "獎(jiǎng)項(xiàng)名稱",
“prize_desc”: "獎(jiǎng)品描述",
"prize_picture": "獎(jiǎng)品圖片鏈接",
"number": "抽中人數(shù)",
"win_prize":"已中獎(jiǎng)名單"
},
{
“prize_name”: "獎(jiǎng)項(xiàng)名稱",
“prize_desc”: "獎(jiǎng)品描述",
"prize_picture": "獎(jiǎng)品圖片鏈接",
"number": "抽中人數(shù)",
"win_prize":"已中獎(jiǎng)名單"
},
]

Sample

[GET] http://localhost:9999/api/v3/activitys/1/page?access_token=xxx&access_type=user

Return:

{
      暫略
}

中獎(jiǎng)用戶名單

API

[GET] /api/v3/activitys/{id}/win_lottery/category

請(qǐng)求參數(shù)

返回參數(shù)

Data:
[
{
“awards”: 獎(jiǎng)項(xiàng)名稱,
“content”:[
{"member_id":"活動(dòng)成員id",“nickname”:"昵稱",“icon”:”頭像鏈接”}，
{"member_id":"活動(dòng)成員id",“nickname”:"昵稱",“icon”:”頭像鏈接”}
]
},
{
“awards”: 獎(jiǎng)項(xiàng)名稱,
“content”:[
{"member_id":"活動(dòng)成員id",“nickname”:"昵稱",“icon”:”頭像鏈接”}琐脏，
{"member_id":"活動(dòng)成員id",“nickname”:"昵稱",“icon”:”頭像鏈接”}
]
}
]

獎(jiǎng)項(xiàng)名單信息:

Sample

[GET] http://localhost:9999/api/v3/activitys/1/win_lottery/category?access_token=xxx&access_type=user

Return:

{
      暫略
}

抽獎(jiǎng)(廢棄，改用批量抽獎(jiǎng)接口）

API

[GET] /api/v3/activitys/{id}/awards/{id}/drawresult

請(qǐng)求參數(shù)

返回參數(shù)

Data:
[
{
"member_id": "活動(dòng)成員id",
"member_nickname": "昵稱",
"member_icon": "xxx",
"member_real_name": "xxx",
"member_phone": "手機(jī)號(hào)碼"
},
{
"member_id": 1,
"member_nickname": "520",
"member_icon": "xxx",
"member_real_name": "xx",
"member_phone": ""
}
]

獎(jiǎng)項(xiàng)名單信息:

Sample

[GET] http://localhost:9999/api/v3/activitys/2/awards/5/drawresult?access_token=xxx&access_type=user

Return:

{
  "code": 0,
  "msg": "抽獎(jiǎng)成功",
  "data": [
    {
      "member_id": 2,
      "member_nickname": "520too",
      "member_icon": "xxx",
      "member_real_name": "xxx",
      "member_phone": 13800138000
    },
    {
      "member_id": 1,
      "member_nickname": "520",
      "member_icon": "xxx",
      "member_real_name": "xx",
      "member_phone": 0
    }
  ]
}

批量抽獎(jiǎng)

API

[GET] /api/v3/activitys/{id}/awards/{id}/batchdraw/{num}

請(qǐng)求參數(shù)

返回參數(shù)

Data數(shù)據(jù)項(xiàng):

Sample

[GET] http://localhost:9999/api/v3/activitys/2/awards/5/batchdraw/1?access_token=xxx&access_type=user

Return:

{
  "code": 0,
  "msg": "抽獎(jiǎng)成功",
"data": [
    {
      "member_id": 2,
      "member_nickname": "520too",
      "member_icon": "xxx",
      "member_real_name": "xxx",
      "member_phone": 13800138000
    },
    {
      "member_id": 1,
      "member_nickname": "520",
      "member_icon": "xxx",
      "member_real_name": "xx",
      "member_phone": 0
    }
  ]
}

導(dǎo)出參與名單的報(bào)表模板

API

[GET] /api/v3/activitys/{id}/excel_template

返回

excel表import_members_template.xlsx

導(dǎo)入?yún)⑴c名單

API

[POST] /api/v3/activitys/{id}/batch_members

請(qǐng)求參數(shù)

返回參數(shù)

若失敗日裙，data數(shù)組的每個(gè)數(shù)據(jù)項(xiàng)格式：

{
  member_name:  姓名
  member_phone: 手機(jī)
  msg: 失敗原因
}

內(nèi)定中獎(jiǎng)名單列表

API

[GET] /api/v3/activitys/{id}/default_win_list

請(qǐng)求參數(shù)

返回參數(shù)

data數(shù)組數(shù)據(jù)項(xiàng)格式:

member_status:

{
   0：未中獎(jiǎng)
   1：已中獎(jiǎng)
}

獲取待添加到內(nèi)定名單的列表

API

[GET] /api/v3/activitys/{id}/members_for_set_default_win

請(qǐng)求參數(shù)

返回參數(shù)

Data:

{
      "total": 整數(shù)
      "current_page": 數(shù)組
}

current_page數(shù)組的數(shù)據(jù)項(xiàng)格式:

member_source:

{
  'wx':來源是微信
  'offline':線下導(dǎo)入
}

添加內(nèi)定中獎(jiǎng)人

API

[POST] /api/v3/activitys/{id}/add_default_winer/add/{member_id}/to/{awards_id}
[POST] /api/v3/activitys/{id}/add_default_winer/{member_id}

返回參數(shù)

修改內(nèi)定中獎(jiǎng)人的關(guān)聯(lián)獎(jiǎng)項(xiàng)

API

[PUT] /api/v3/activitys/{id}/awards_relation/relate/{member_id}/to/{awards_id}

返回參數(shù)

獎(jiǎng)項(xiàng)列表

API

[GET] /api/v3/activitys/{id}/awards_list

返回參數(shù)

刪除參與抽獎(jiǎng)成員

API

[DELETE] /api/v3/activitys/{id}/join_member/{member_id}

返回參數(shù)

刪除內(nèi)定中獎(jiǎng)成員

API

[DELETE] /api/v3/activitys/{id}/default_winer/{member_id}

返回參數(shù)