[关闭]
@chenwei123 2016-07-27T06:30:29.000000Z 字数 8423 阅读 420

优惠券

益安

1. 创建优惠券

Description

用户创建优惠券

Method and URL Structure

Method Resource URL
POST /coupon/coupons/

Request Parameters

Name Description Required Default
source 来源 Yes
amount 优惠券金额 Yes
start_price 起步价 NO
start_time 开始时间 NO
end_time 结束时间 NO
limit_number 限领次数 NO 1

source,0(直接发放)、1(点击领取)、2(抽奖发放)

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

Request

  1. {
  2.     "source":0,
  3.     "amount":5,
  4.     "start_price":5,
  5.     "start_time":"2016-07-01 00:00:00",
  6.     "end_time":"2016-07-03 00:00:00",
  7. }

cURL Example

  1. curl -X POST -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' -d 'source=0&amount=5&start_price=5&start_time=2016-07-01 00:00:00&end_time=2016-07-03 00:00:00' http://127.0.0.1:8000/coupon/coupons/

JSON Response

  1. {
  2.     "pk": 12,
  3.     "owner": "root",
  4.     "source": 0,
  5.     "amount": 5,
  6.     "start_price": 5,
  7.     "start_time": "2016-07-01T00:00:00Z",
  8.     "end_time": "2016-07-03T00:00:00Z",
  9.     "limit_number":1,
  10. }

2. 修改优惠券信息

Description

用户修改优惠券的信息

Method and URL Structure

Method Resource URL
PUT /coupon/coupons/${pk}/

Request Parameters

Name Description Required Default
source 来源 NO
amount 优惠券金额 Yes
start_price 起步价 NO
start_time 开始时间 NO
end_time 结束时间 NO
limit_number 限领次数 NO 1

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

Request

  1. {
  2.     "source": 0,
  3.     "amount": 5,
  4.     "start_price": 5,
  5.     "start_time": "2016-07-01T00:00:00Z",
  6.     "end_time": "2016-07-03T00:00:00Z"
  7. }

cURL Example

  1. curl -X PUT -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' -d 'source=0&amount=5&start_price=5&start_time=2016-07-01 00:00:00&end_time=2016-07-03 00:00:00' http://127.0.0.1:8000/coupon/coupons/

JSON Response

  1. {
  2.     "pk": 12,
  3.     "owner": "root",
  4.     "source": 0,
  5.     "amount": 5,
  6.     "start_price": 5,
  7.     "start_time": "2016-07-01T00:00:00Z",
  8.     "end_time": "2016-07-03T00:00:00Z",
  9.     "limit_number":1,
  10. }

3. 删除优惠券

Description

用户删除试卷

Method and URL Structure

Method Resource URL
DELETE /coupon/coupons/${pk}/

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

cURL Example

  1. curl -X DELETE -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' http://127.0.0.1:8000/coupon/coupons/1/

JSON Response

Name Description Default
detail 失败原因 Not found
status 成功 204

4. 查看具体优惠券

Description

用户查询某一具体优惠券

Method and URL Structure

Method Resource URL
GET /coupon/coupons/${pk}/

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

cURL Example

  1. curl -X GET -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' http://127.0.0.1:8000/coupon/coupons/1/

JSON Response

  1. {
  2.     "pk": 1,
  3.     "owner": "15670502158",
  4.     "course": null,
  5.     "title": "2015-2016学年初三数学期中考试",
  6.     "point": 20,
  7.     "credit": 50,
  8.     "join_count": 0,
  9.     "create_time": "2016-06-12T02:51:05.236221Z",
  10.     "limit_number":1,
  11. }

5. 获取所有优惠券

Description

用户查看所有的优惠券

Method and URL Structure

Method Resource URL
GET /coupon/coupons/

Request Parameters

默认分页取数据库中最新的10条数据

Name Description Required Default
page page Number Yes 1
source 优惠券来源 No

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

cURL Example

  1. curl -X GET -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' http://127.0.0.1:8000/coupon/coupons/

JSON Response

  1. {
  2.     "count": 7,
  3.     "next": null,
  4.     "previous": null,
  5.     "results": [
  6.         {
  7.             "pk": 11,
  8.             "owner": "root",
  9.             "source": 0,
  10.             "amount": 10,
  11.             "start_price": 0,
  12.             "start_time": "2016-06-29T08:08:14.468451Z",
  13.             "end_time": null,
  14.             "limit_number":1,
  15.         },
  16.         {
  17.             "pk": 12,
  18.             "owner": "root",
  19.             "source": 0,
  20.             "amount": 5,
  21.             "start_price": 5,
  22.             "start_time": "2016-07-01T00:00:00Z",
  23.             "end_time": "2016-07-03T00:00:00Z",
  24.             "limit_number":1,
  25.         },
  26.         ...
  27.     ]
  28. }

00. 用户领取优惠券(限总张数、限领)

Description

用户领取优惠券创建记录

Method and URL Structure

Method Resource URL
POST /coupon/coupon_total_limit/

Request Parameters

Name Description Required Default
coupon 优惠券pk/id Yes

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

Request

  1. {
  2.    "coupon":1,
  3. }

cURL Example

  1. curl -X POST -H 'Authorization: Token 2deb42c137dbe6353d145559121bacd77fa77313cf0075c51ed608999363b1fa' -d 'coupon=1' http://127.0.0.1:8000/coupon/coupon_total_limit/

JSON Response Failure

  1. 第一种情况：
  2. {"status":-4,"message":"你已经领过了,不能再领了"}
  3. 第二种情况：
  4. {"status":-4,"message":"不好意思,您来晚了。下次请早!"}

JSON Response Success

  1. {
  2.     "pk": 1,
  3.     "user": "root",
  4.     "coupon": 1,
  5.     "receive_time": "2016-06-30T06:48:17.240994Z",
  6.     "spend_time": "2016-06-30T06:48:17.240596",
  7.     "used": false,
  8.     "order_no": null,
  9.     "ineffect": false
  10. }

0. 用户领取优惠券(限领)

Description

用户领取优惠券创建记录

Method and URL Structure

Method Resource URL
POST /coupon/coupon_limit/

Request Parameters

Name Description Required Default
coupon 优惠券pk/id Yes

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

Request

  1. {
  2.    "coupon":1,
  3. }

cURL Example

  1. curl -X POST -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' -d 'coupon=1' http://127.0.0.1:8000/coupon/coupon_limit/

JSON Response Failure

  1. {"status":-4,"message":"你已经领过了,不能再领了!"}

JSON Response Success

  1. {
  2.     "pk": 1,
  3.     "user": "root",
  4.     "coupon": 1,
  5.     "receive_time": "2016-06-30T06:48:17.240994Z",
  6.     "spend_time": "2016-06-30T06:48:17.240596",
  7.     "used": false,
  8.     "order_no": null,
  9.     "ineffect": false
  10. }

1. 创建优惠券的记录

Description

用户领取优惠券创建记录

Method and URL Structure

Method Resource URL
POST /coupon/coupon_records/

Request Parameters

Name Description Required Default
coupon 优惠券pk/id Yes

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

Request

  1. {
  2.    "coupon":1,
  3. }

cURL Example

  1. curl -X POST -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' -d 'coupon=1' http://127.0.0.1:8000/coupon/coupon_records/

JSON Response

  1. {
  2.     "pk": 1,
  3.     "user": "root",
  4.     "coupon": 1,
  5.     "receive_time": "2016-06-30T06:48:17.240994Z",
  6.     "spend_time": "2016-06-30T06:48:17.240596",
  7.     "used": false,
  8.     "order_no": null,
  9.     "ineffect": false
  10. }

2. 修改优惠券记录

Description

用户修改优惠券记录的信息

Method and URL Structure

Method Resource URL
PUT /coupon/coupon_records/${pk}/

Request Parameters

Name Description Required Default
coupon 优惠券资源的pk/id Yes
order_no 订单编号 NO
spend_time 花费优惠券的时间 NO
used 是否使用 NO

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

Request

  1. {
  2.    "coupon":1,
  3. }

cURL Example

  1. curl -X PUT -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' -d 'coupon=1' http://127.0.0.1:8000/coupon/coupon_records/1/

JSON Response

  1. {
  2.     "pk": 1,
  3.     "user": "root",
  4.     "coupon": 1,
  5.     "receive_time": "2016-06-30T06:48:17.240994Z",
  6.     "spend_time": "2016-06-30T06:48:17.240596",
  7.     "used": false,
  8.     "order_no": null,
  9.     "ineffect": false
  10. }

3. 删除优惠券的记录

Description

用户删除优惠卷的记录

Method and URL Structure

Method Resource URL
DELETE /coupon/coupon_records/${pk}/

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

cURL Example

  1. curl -X DELETE -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' http://127.0.0.1:8000/coupon/coupon_records/1/

JSON Response

Name Description Default
detail 失败原因 Not found
status 成功 204

4. 查看具体优惠券的记录

Description

用户查询某一具体优惠券的记录

Method and URL Structure

Method Resource URL
GET /coupon/coupon_records/${pk}/

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

cURL Example

  1. curl -X GET -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' http://127.0.0.1:8000/coupon/coupon_records/1/

JSON Response

  1. {
  2.     "pk": 1,
  3.     "user": "root",
  4.     "coupon": 1,
  5.     "receive_time": "2016-06-30T06:48:17.240994Z",
  6.     "spend_time": "2016-06-30T06:48:17.240596",
  7.     "used": false,
  8.     "order_no": null,
  9.     "ineffect": false
  10. }

5. 获取我的优惠券

Description

用户查看所有的优惠券记录

Method and URL Structure

Method Resource URL
GET /coupon/coupon_records/

Request Parameters

默认分页取数据库中最新的10条数据

Name Description Required Default
page page Number Yes 1

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

cURL Example

  1. curl -X GET -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' http://127.0.0.1:8000/coupon/coupon_records/

JSON Response

  1. {
  2.     "count": 2,
  3.     "next": null,
  4.     "previous": null,
  5.     "results": [
  6.         {
  7.             "pk": 2,
  8.             "user": "root",
  9.             "coupon": 2,
  10.             "receive_time": "2016-06-30T07:32:39.050840Z",
  11.             "spend_time": "2016-06-30T07:32:25Z",
  12.             "used": false,
  13.             "order_no": "",
  14.             "ineffect": true
  15.         },
  16.         {
  17.             "pk": 1,
  18.             "user": "root",
  19.             "coupon": 1,
  20.             "receive_time": "2016-06-30T06:48:17.240994Z",
  21.             "spend_time": "2016-06-30T06:48:17.240596Z",
  22.             "used": false,
  23.             "order_no": null,
  24.             "ineffect": false
  25.         }
  26.     ]
  27. }

5. 获取我的优惠券总数

Description

用户查看所有的优惠券记录

Method and URL Structure

Method Resource URL
GET /coupon/coupon_records/number/

Request Header

Name Description Required Default
Authorization Token 7309fabd207c22e0a00eada158989b89ffe839ef Yes

＊Authorization的值为登录成功后返回值

cURL Example

  1. curl -X GET -H 'Authorization: Token 610c16955313b1f1755857d44ce3a80c29f222d7' http://127.0.0.1:8000/coupon/coupon_records/number/

JSON Response

  1. {
  2.   "number": 1
  3. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注