liuming / developer-docs

上一级

---

接口说明

• 请求地址 /api/teacher/has_red_envelopes

• 请求方式 POST

• 请求参数

参数	说明	必选？
userId	用户id，整数，不能为null	是
realName	真实名字，字符串	否
redEnvelopeValue	红包金额，单位分，整数，不能为空	是
redEnvelopeId	红包id，整数，不能为空	是
comment	描述、备注，可以为空	否

• 返回保存后的数据

  {
  "data": [
  {
    "name": "星级教师",
    "value": 5000,
    "sendDate": "2016-07-15",
    "comment":""
  },
  {
    "name": "推荐",
    "value": 5000,
    "sendDate": "2016-07-15",
    "comment":""
  },
  {
    "name": "推荐",
    "value": 5000,
    "sendDate": "2016-07-15",
    "comment":""
  },
  {
    "name": "推荐",
    "value": 5000,
    "sendDate": "2016-07-15",
    "comment":""
  },
  {
    "name": "推荐",
    "value": 5000,
    "sendDate": "2016-07-15",
    "comment":""
  },
  {
    "name": "自定义",
    "value": 5000,
    "sendDate": "2016-07-16",
    "comment":""
  }
  ]
  }
  

  异常

• 1. 传递的id不对

返回： http状态码 400

内容

{
  "message": "userId is invalid !",
  "code": "invalid_param"
}

• 2. 重复发星级教师红包

返回 http状态码 409

内容

{
  "message": "【星级教师】红包一个老师只能发一个!",
  "code": "duplicated"
}

• 3. 失败

返回 http状态码 422

内容

  {
    "message": "notice finance failed\nmessage:500 null",
    "code": "save_error"
  }