跳转到: 导航, 搜索
(以“{{Api_desc_business| uri=notification/receive_list| desc=获取当前用户收到的最新通知列表。| httpMethod=GET| needAuth=是| rateLimit={{B_rate_limit}}| ...”为内容创建页面)
 
第1行: 第1行:
{{Api_desc_business|
+
{{api_desc_v2|
 
uri=notification/receive_list|
 
uri=notification/receive_list|
desc=获取当前用户收到的最新通知列表。|
+
desc=获取当前用户收到的最新通知列表|
 
httpMethod=GET|
 
httpMethod=GET|
 
needAuth=是|
 
needAuth=是|
rateLimit={{B_rate_limit}}|
+
level={{Api_L2}}|
params={{api_args|page|false|int|返回结果的页码,默认为1。}}
+
rateLimit=是|
 +
params=
 +
{{api_args|page|false|int|返回结果的页码,默认为1。}}
 
{{api_args|count|false|int|单页返回的记录条数,不能超过200,默认为20。}}|
 
{{api_args|count|false|int|单页返回的记录条数,不能超过200,默认为20。}}|
 
result=
 
result=
第27行: 第29行:
 
</pre>|
 
</pre>|
 
resultDes=无|
 
resultDes=无|
useAge=*因为定期会将旧的通知数据清空,所以通过翻页可以取得所有存在的通知信息,无统一的上线限制;|
+
useAge=
 +
*返回调用接口的当前登录用户的通知数据;|
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

2012年5月29日 (二) 13:52的版本

notification/receive_list

获取当前用户收到的最新通知列表

URL

https://api.weibo.com/2/notification/receive_list.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制

访问级别:高级接口(需要授权)
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
page false int 返回结果的页码,默认为1。
count false int 单页返回的记录条数,不能超过200,默认为20。

注意事项

  • 返回调用接口的当前登录用户的通知数据;

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "notification": [
        {
            "notification_id": 12035,
            "title": "test",
            "content": "test",
            "created_at": "Wed Jan 06 11:26:01+0800 2010",
            "sender_app": {
                "appkey62": "4Gcqmc"
            },
            "sender_uid": 1658122963
        },
        ...
    ],
    "total_number": 20
}

关于错误返回值与错误代码,参见 错误代码说明

返回字段说明

其他

相关问题

{{{relat_qa}}}


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




api评价