wiki:app2.0/03_personal

Version 59 (modified by wuyuanbo, 9 years ago) (diff)

--

Table of Contents

  1. 获取用户资料
  2. 获取用户扩展信息
  3. 检查签到状态
  4. 签到
  5. 用户签到记录
  6. 补签
  7. 我收到的评论 改动
  8. 我发出的评论
  9. 获得系统通知(2.5之前旧版本使用)
  10. 获得系统通知（2.5之后版本使用）
  11. 获得系统和评论通知数量
  12. 获取用户是否在某个时间之后是否有新审核通过的爆料数、未读的评论、未读的消息
  13. 获取用户金币积分等记录

个人中心

获取用户资料

线上： /app/my/user/getUserInfo.do

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
common_session_id - String""是

返回* 

result {
        status:1, 
    msg '请求成功',
        data: {
            $user
        }
}

$user

获取用户扩展信息

线上： /app/my/user/getUserExtend.do

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
common_session_id - String""是

返回 

result {
        status:1, 
    msg '请求成功',
        data: {
            $userExtend
        }
}

$userExtend

检查签到状态

线上： /app/my/signIn/checkSignInStatus.do

说明

检查签到状态

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
common_session_id - String""是

返回 

result {
    status: 1,
    msg: '已签到',
    data: {
        signInStatus: 1,  // 0 未签到   1 已签到
        days: 12  // 连续签到次数
    }
}

签到

线上： /app/my/signIn/signInfForApp.do

说明

app端签到

提交方式

POST

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
common_session_id - String""是

返回 

result {
    status: 1,
    msg: '签到成功',
    data:{
        signInStatus: 1,   // 1 签到成功     2  已经签到过了
        addInt: 10,  // 新增积分
        addCoin: 12,  // 新增金币
        point: 10, // 当前积分
        gold: 10, 当前金币
        addPurchasingGold： 10,  // 新增钻石
        day: 1  // 当前连续签到天数 
    }
}

用户签到记录

线上： /app/my/signIn/getSignInRecord.do

说明

用户某年某月的签到记录

提交方式

GET/POST

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
year 年份 最小为2014，最大不能超过当前年份int2016是
month月份 1-12int9是
common_session_id - String""是

返回 

result {
    status: 1 / -1 /-3,
    msg: '获取成功 / 系统出错 / 参数错误',
    data:[ 
         $checkinLog
    ]
}

$checkinLog

补签

线上： /app/my/signIn/retroactive.do

说明

当月可以补签，补签会扣除金币

提交方式

POST

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
days 几号 String"1,3,6,10"是
common_session_id - String""是

返回 

result {
    status: 1,
    msg: '补签成功'
    data: {
       total: 10,     //成功补签的天数
       gold: 1,       //用户剩余金币
       experience,    //用户经验
       score,         //用户积分
       pristige,      //用户威望   
       purchasingGold //用户剩余钻石
    }
}
状态 含义
1 补签成功
-1 系统错误
-2 未登录
-3 参数有误
-4 提交过于频繁，请稍后再试！
-10 金币不足
-11 经验不足
-12 威望不足
-13 积分不足
-14 钻石不足

我收到的评论 改动

线上： /app/my/comment/listMyReceiveComment.do

说明

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int10是
common_session_id - String""是

返回 

result {
        pageNo： 1,
        pageSize: 10,
        total: 20,
        pageTotal: 2,
        msg: '请求成功',
        data: [
        $receiveComment
        ]
}

$receiveComment

我发出的评论

线上： /app/my/comment/listMySendComment.do

说明

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int10是
common_session_id - String""是

返回 

result {
    pageNo： 1,
    pageSize: 10,
    total: 20,
        pageTotal: 2,
        msg: '请求成功',
        data: [
        $sendComment
        ]
}

$sendComment

获得系统通知(2.5之前旧版本使用)

线上： /app/my/systemNotice/listAllNotice.do

说明

获得系统通知，包括官代的物流消息和交易消息，2.5之前版本没有区分消息类型。

新版本已将给类型消息区分，系统消息请调用listSystemNotice.do，如需调用交易消息和物流消息请使用官方代购提供的消息接口。  交易消息  物流消息

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int10是
common_session_id - String""是

返回

*注意：该接口返回格式为bip的接口格式，与其他接口不一致。* 

result {
        pageCount: 15,
        pageNo: 1,
        pageSize: 10,
        total: 2,
        resultList: [{
            accountId: 28467067,  // 接收用户Id
            content: "对您的爆料《罗技 UE4000 游戏耳机 试用报告》的反馈：部分图片可以使用800px宽，可能会稍微好点",  // 消息内容
            createTime: 1411615093000,  // 创建时间
            groupSend: 0,
            groupType: 0,
            id: 97207866,  // 消息id
            resultText: "",
            senderId: 0,  // 发送者id
            siteId: 1,  // 网站id，1表示电脑网
            status: 1,  //消息状态 0未读  1已读
            type: {
                description: "今日最超值",  // 应用描述
                groupType: 0,
                id: 1006,  // 应用id  1006表示聚超值
                name: "今日最超值",  // 应用名称
                siteId: 1,  // 网站id
                templateId: 1006  // 消息模板id
            },
            typeId: 1006  // 类型， 1006表示聚超值的消息
        }]
    }

获得系统通知（2.5之后版本使用）

线上： /app/my/systemNotice/listSystemNotice.do

说明

获得系统通知(不包含物流消息和交易消息)。如需调用交易消息和物流消息请使用官方代购提供的消息接口。

 交易消息  物流消息

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int10是
common_session_id - String""是

返回

*注意：该接口返回格式为bip的接口格式，与其他接口不一致。* 

result {
        pageCount: 15,
        pageNo: 1,
        pageSize: 10,
        total: 2,
        resultList: [{
            accountId: 28467067,  // 接收用户Id
            content: "对您的爆料《罗技 UE4000 游戏耳机 试用报告》的反馈：部分图片可以使用800px宽，可能会稍微好点",  // 消息内容
            createTime: 1411615093000,  // 创建时间
            groupSend: 0,
            groupType: 0,
            id: 97207866,  // 消息id
            resultText: "",
            senderId: 0,  // 发送者id
            siteId: 1,  // 网站id，1表示电脑网
            status: 1,  //消息状态 0未读  1已读
            type: {
                description: "今日最超值",  // 应用描述
                groupType: 0,
                id: 1006,  // 应用id  1006表示聚超值
                name: "今日最超值",  // 应用名称
                siteId: 1,  // 网站id
                templateId: 1006  // 消息模板id
            },
            typeId: 1006  // 类型， 1006表示聚超值的消息
        }]
    }

获得系统和评论通知数量

线上： /app/my/systemNotice/getSysNoticeAndCommentNum.do

说明

获得系统通知数量和评论数量

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
common_session_id - String""是

返回 

result {
    status： 1
    msg: '请求成功',
    data: {
        sentCount: 1,
        receiveCount: 2,
        sysMsgCount: 3
    }
}

获取用户是否在某个时间之后是否有新审核通过的爆料数、未读的评论、未读的消息

线上： /app/my/getNewCountForApp.do

说明

获取用户某个时间之后的爆料数,评论数和系统消息数

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
common_session_id - String""是
lastAccessTime最近一次访问该接口的时间long(时间戳 毫秒)当前时间是

返回 

result {
    status： 1
    msg: '请求成功',
    data: {
        
        //虽然字段名有Count，但是返回的数据代表的是状态。

        newTopicCount: 1,        //0用户没新审核的爆料，1用户有新审核的爆料
        newCommentCount: 1,      //0用户没未读评论，1用户有未读的评论
        newSystemNoticeCount: 1, //0用户没未读消息，1用户有未读的消息
    }
}

获取用户金币积分等记录

线上： /app/my/moneyLog/getMoneyLogList.do

提交方式

GET

是否需要登录

是

缓存方式

无

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
common_session_id - String""是
pageSize 返回数据个数 int20否
pageNo 返回数据页数 int1否

返回 

result {
        status: 1, 
        msg ': 请求成功',
        pageNo： 1,
        pageSize: 10,
        total: 20,
        pageTotal: 2,
        data: [
            $moneyLog,
            ...
        ]
}

 $moneyLog