[关闭]
@apis1990 2016-08-14T03:41:35.000000Z 字数 2622 阅读 450

v2-教练端


获取教练端消息列表


1.URL:/service/api/v2/coachuser/get_message_list.php

测试地址:http://36.33.24.119:8081/api/v2/coachuser/get_message_list.php

2.请求方式:POST

3.请求参数:

参数 类型 是否必须 描述
coach_id int yes 教练ID 如:26
member_type int yes 成员类型,教练端请传值:2
sms_type int yes 消息类型: 1系统消息,2订单消息, 3消息分类页 ,0 app首页消息
-- -- -- --
sort string optional 排序字段,请传is_read
order string optional 控制倒序或逆序,倒序:DESC,正序:ASC, [ 默认:DESC ]
page int optional 消息分页数,如第二页请传数字2 [ 默认:1 ]

5.接口返回结果

demo1

  1. {
  2. "code": 106,
  3. "data": "请求错误"
  4. }
  1. 参数:请求方式GET
  2. 解释:使用了除POST以外的请求方式
  3. 修复:请使用POST
  4. 状态:出错

demo2

  1. {
  2. "code": 102,
  3. "data": "参数错误"
  4. }
  1. 参数:sms_type=2&member_type=2
  2. 解释:参数coach_id为必须,该参数缺失
  3. 修复:请添加coach_id=[数字]参数
  4. 状态:出错

demo3

  1. {
  2. "code": "200",
  3. "data": "47" //N条消息
  4. }
  1. 参数:sms_type=0&member_type=2&coach_id=26
  2. 解释:表示app首页请求,有47条新消息
  3. 状态:正常

demo4

  1. {
  2. "code": "200",
  3. "data": {
  4. "1": 23, //消息类型:未读消息数目
  5. "2": 1
  6. }
  7. }
  1. 参数:sms_type=3&member_type=2&coach_id=26
  2. 解释:共有未读消息:系统消息 1 条, 订单消息 46 条,
  3. 状态:正常

demo5

  1. {
  2. "code": "200",
  3. "data": [
  4. {
  5. "id": "4936",
  6. "content": "教练您好,陈曦学员预约您3月12日8:00-9:00点的学车服务,请提前做好安排!",
  7. "from": "嘻哈学车",
  8. "beizhu": "学员订单",
  9. "addtime": "1457601554",
  10. "is_read": "2", //2表示 未读 1 表示已读 101 表示已删除
  11. "msg_type": "2"
  12. },
  13. {
  14. "id": "4934",
  15. "content": "教练您好,高大成学员预约您3月10日19:00-20:00点的学车服务,请提前做好安排!",
  16. "from": "嘻哈学车",
  17. "beizhu": "学员订单",
  18. "addtime": "1457592502",
  19. "is_read": "2",
  20. "msg_type": "2"
  21. },
  22. {
  23. "id": "4932",
  24. "content": "教练您好,高大成学员预约您3月13日11:00-12:00点的学车服务,请提前做好安排!",
  25. "from": "嘻哈学车",
  26. "beizhu": "学员订单",
  27. "addtime": "1457592205",
  28. "is_read": "2",
  29. "msg_type": "2"
  30. },
  31. {
  32. "id": "4930",
  33. "content": "教练您好,高大成学员预约您3月15日18:00-19:00点的学车服务,请提前做好安排!",
  34. "from": "嘻哈学车",
  35. "beizhu": "学员订单",
  36. "addtime": "1457592022",
  37. "is_read": "2",
  38. "msg_type": "2"
  39. },
  40. {
  41. "id": "4928",
  42. "content": "教练您好,高大成学员预约您3月15日20:00-21:00点的学车服务,请提前做好安排!",
  43. "from": "嘻哈学车",
  44. "beizhu": "学员订单",
  45. "addtime": "1457591943",
  46. "is_read": "2",
  47. "msg_type": "2"
  48. },
  49. {
  50. "id": "4926",
  51. "content": "教练您好,高大成学员预约您3月16日20:00-21:00点的学车服务,请提前做好安排!",
  52. "from": "嘻哈学车",
  53. "beizhu": "学员订单",
  54. "addtime": "1457591873",
  55. "is_read": "2",
  56. "msg_type": "2"
  57. },
  58. {
  59. "id": "4924",
  60. "content": "教练您好,高大成学员预约您3月10日20:00-21:00点的学车服务,请提前做好安排!",
  61. "from": "嘻哈学车",
  62. "beizhu": "学员订单",
  63. "addtime": "1457591706",
  64. "is_read": "2",
  65. "msg_type": "2"
  66. },
  67. {
  68. "id": "4922",
  69. "content": "教练您好,高大成学员预约您3月15日19:00-20:00,21:00-22:00点的学车服务,请提前做好安排!",
  70. "from": "嘻哈学车",
  71. "beizhu": "学员订单",
  72. "addtime": "1457581773",
  73. "is_read": "2",
  74. "msg_type": "2"
  75. },
  76. {
  77. "id": "4920",
  78. "content": "教练您好,高大成学员预约您3月12日21:00-22:00点的学车服务,请提前做好安排!",
  79. "from": "嘻哈学车",
  80. "beizhu": "学员订单",
  81. "addtime": "1457580956",
  82. "is_read": "2",
  83. "msg_type": "2"
  84. },
  85. {
  86. "id": "4918",
  87. "content": "教练您好,高大成学员预约您3月13日8:00-9:00,9:00-10:00,10:00-11:00点的学车服务,请提前做好安排!",
  88. "from": "嘻哈学车",
  89. "beizhu": "学员订单",
  90. "addtime": "1457580066",
  91. "is_read": "2",
  92. "msg_type": "2"
  93. }
  94. ]
  95. }
  1. 参数:sms_type=2&member_type=2&coach_id=26&page=2&sort=is_read&order=DESC
  2. 状态:正常
  3. 解释:此为教练id26的所有订单消息中的第 2 页,先按未读和已读排序,排序方式为已读>未读,然后是按消息的推送时间从最新开始排序。 如果不传page,则page默认为第一页; 如果不传sort,则默认只按时间排序,即未读和已读是混杂在一起的;如果不传order,则先是已读,再是未读。
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注