huayandong / recommend-api

四会课程 小程序领取接口

1. 微信用户登录

• URL: {{localhost}}/boxfish-online-card/wxUser/userLogin
• Method: POST
• RequestBody:

{
  // 登录凭证
  "jsCode": "wx_jsCode",
  // 用户信息
  "nickName": "user_nickName",
  "avatarUrl":"user_avatarUrl"
}

• ResponseBody:

    // status
    private ResponseStatus status;
    private String message;
    // body
    private String openId;
    private String wxToken;

2. 通过邀请码，建立邀请关系

• URL: {{localhost}}/boxfish-online-card/wxUser/addRelationship
• Method: POST
• RequestBody:

{
    "openId": "user_openId",
    "invitationCode": "invitation_code"
}

• ResponseBody:

public static class Response {
    // status
    private ResponseStatus status;
    private String message;

    // 分享人信息
    private String sourceOpenId;
    private String sourceNickName;
    private String sourceAvatarUrl;
    // 领取人信息
    private String targetOpenId;
    private String targetNickName;
    private String targetAvatarUrl;

    // 用户当前状态
    private Boolean flagUserHasObtain;  // 是否领取课程
    private Long invitationCode;        // 已经领取，返回当前用户的邀请码
}

3. 微信用户获取全部的教材版本、年级信息

• URL: {{localhost}}/boxfish-online-card/textbook/version/getTextbookGrade
• Method: POST
• RequestBody: json字符串

4. 【此接口弃用】用户提交教材版本、手机号、地址信息

• URL: {{localhost}}/boxfish-online-card/textbook/version/submitTextbookVersion
• Method: POST
• RequestBody:

public static class Request {
    private String name;        // 收货人名称
    private String mobile;
    private String address;
    private String versionCode;

    private String openId;
    private Long invitationCode;
}

• ResponseBody:

public static class Response {
    // status
    private ResponseStatus status;
    private String message;

    private Long invitationCode;
}

4.1. 用户提交教材版本、手机号、地址信息，领取四会课程

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

• RequestBody:

  public static class Request {
  private String versionCode;     // 领取versionCode
  
  private String orderName;       // 收货人名称
  private String orderMobile;     // 收货人手机号
  private String orderProvince;   // 省
  private String orderCity;       // 市
  private String orderDistrict;   // 区
  private String orderAddressDetail;  // 详细地址
  
  private String openId;          // 微信openId
  private Long invitationCode;    // 邀请人的邀请码
  }
  

5. 查询已经领取的教材信息、邀请的用户信息

• URL: {{localhost}}/boxfish-online-card/textbook/obtain/getObtainTextbook
• Method: POST

• RequestBody:

  {
  "openId": "wx_user_openId"
  }
  

• ResponseBody:

public static class Response {
    // status
    private ResponseStatus status;
    private String message;

    // 邀请码
    private Long invitationCode;
    // 领取的课程信息
    private List<TextbookInfo> textbookList = new ArrayList<>();
    // 邀请的好友信息
    private List<WxUserInfo> targetWxUserList = new ArrayList<>();
}

// `textbookList` 信息
public static class TextbookInfo {
    private String textbookCover;
    private String textbookLabel;
}

// `targetWxUserList` 信息
public static class WxUserInfo {
    private String openId;
    private String nickName;
    private String avatarUrl;
    private Boolean flagPlaceOrder;
}

6. 缺用户是否已经建立过绑定关系，如果建立过，返回之前绑定关系的邀请码

• URL: {{localhost}}/boxfish-online-card/wxUser/confirm
• Method: POST

• RequestBody:

  {
  "openId": "wx_user_openId"
  }
  

• ResponseBody:

public static class Response {
    // status
    private ResponseStatus status;
    private String message;

    private Boolean flagUserHasInvitationCode;
    private Long invitationCode;
}