2/messages/v unread count

跳转到: 导航, 搜索

获取与指定蓝V的往来私信未读数接口

接口调用地址:https://m.api.weibo.com/2/messages/v_unread_count.json


HTTP请求方式:GET


是否需要登陆:是


频次限制:是


接口请求参数
参数名称 值的类型 是否必填 说明描述
access_token string true 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。
uid int64 true 消息接收方蓝V用户ID。

注意事项

  • 1, 当前用户需要先完成Scope 授权,对应的scope权限参数为:direct_messages_read;
  • 2, 指定的uid用户为蓝V;
  • 3, 指定的uid蓝V用户已设置成将自己的微博私信、留言等消息箱服务交给当前应用托管;
  • 4, 指定的uid蓝V用户已开启推送服务(当前托管即自动开启);
  • 5, 当前登录用户必须为uid蓝V用户的粉丝;

返回结果

// 成功返回
{
    "dm": 3
}

// 失败返回
{
    "request": "/2/messages/v_unread_count.json",
    "error_code": "264XX",
    "error": "error message."
}