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;
}

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;
}