huayandong / recommend-api

四会课程 管理后台接口

1. 查询全部领取的信息

• URL: {{localhost}}/boxfish-online-card/order/textbook/manage/getOrderHistory
• Method: POST
• RequestBody:

public static class Request {
    // request
    private Integer startPage = 0;
    private Integer pageSize = 40;

    private Long userId;

    // exchange packageCode
    private String versionCode;
    // exchange userId
    private String orderName;
    private String orderMobile;
    private Long invitationCode;

    private DateTime orderStartTime;
    private DateTime orderEndTime;
}

• ResponseBody

public static class OrderSummary {
    private Long id;

    private String sourceWxNickName;        // 邀请人 昵称
    private Long sourceInvitationCode;      // 邀请人 邀请码

    private Long userId;                    // 领取人 ID
    private String orderMobile;             // 领取人 手机号
    private String orderName;               // 领取人 收货名称

    private String orderCode;
    private DateTime orderTime;
    private String versionGrade;

    private String orderProvince;
    private String orderCity;
    private String orderCounty;
    private String orderAddressDetail;

    private Boolean flagEnable;     // 是否需要邮寄
    private Boolean flagPost;       // 是否已邮寄
    private DateTime postTime;      // 邮寄时间

    private String obtainType;      // 领取方式：WX_MINI_OBTAIN(小程序领取)， WX_MINI_SHARE("小程序分享赠送"),MANAGE_OBTAIN("后台领取");
    private String courseType;      // 课程类型：COURSE_TEXTBOOK_V2_WORD(四会单词课)，COURSE_JHXXQ(小学期课)
}

2. 修改邮寄状态接口

• URL: {{localhost}}/boxfish-online-card/order/textbook/manage/updatePostTime
• Method: POST
• RequestBody:

{
  "orderCode":"text_orderCode",

  "flagPost": "true",           // 是否邮寄
  "flagEnable": "flagEnable"    // 是否需要邮寄
}

3. 后台页面赠送学生四会课接口

• URL: {{localhost}}/boxfish-online-card/order/textbook/manage/submitUserOrder
• Method: POST
• RequestBody:

public static class Request {
    private Long userId;            // 收货人盒子鱼ID
    private String versionCode;     
    private Long sourceInvitationCode;  // 该收货人的邀请人

    private String orderName;
    private String orderMobile;

    private String orderProvince;
    private String orderCity;
    private String orderCounty;
    private String orderAddressDetail;
}

4. 查询收货人信息接口

• URL: {{localhost}}/boxfish-online-card/order/textbook/getObtainAddress
• Method: POST
• RequestBody:

{
    "userId": ""
}

5. 后台页面赠送学生 精华小学期课程接口

• URL: {{localhost}}/boxfish-online-card/order/textbook/manage/submitOrderXxq
• Method: POST
• RequestBody:

public static class Request {
    private Long userId;            // 收货人盒子鱼ID
    private String grade;           // 赠送小学期的年级
    private Long sourceInvitationCode;  // 该收货人的邀请人

    private String orderName;
    private String orderMobile;

    private String orderProvince;
    private String orderCity;
    private String orderCounty;
    private String orderAddressDetail;
}

grade枚举值：

GRADE_1_A, GRADE_1_B, GRADE_2_A, GRADE_2_B, GRADE_3_A, GRADE_3_B, GRADE_4_A, GRADE_4_B, GRADE_5_A, GRADE_5_B, GRADE_6_A, GRADE_6_B, GRADE_7_A, GRADE_7_B, GRADE_8_A, GRADE_8_B, GRADE_9_A, GRADE_9_B, GRADE_10_A, GRADE_10_B, GRADE_11_A, GRADE_11_B

6. 后台邮寄列表页面 更新邮寄地址页面

• URL: {{localhost}}/boxfish-online-card/order/textbook/manage/updatePostAddress
• Method: POST
• RequestBody:

{
    "id": 583,
    "orderName": "test-update",
    "orderMobile": "12345678900",
    "orderProvince": "北京",
    "orderCity": "北京",
    "orderCounty": "北京",
    "orderAddressDetail": "北京",
    "postTime": 1559318400000
}