account/profile/basic_update
更新用户的基本信息
URL
https://api.weibo.com/2/account/profile/basic_update.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：高级接口（需要授权）
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| screen_name | true | string | 用户昵称，不可为空。 |
| real_name | false | string | 用户真实姓名。 |
| real_name_visible | false | int | 真实姓名可见范围，0：自己可见、1：关注人可见、2：所有人可见。 |
| province | true | int | 省份代码ID，不可为空。 |
| city | true | int | 城市代码ID，不可为空。 |
| birthday | false | date | 用户生日，格式：yyyy-mm-dd。 |
| birthday_visible | false | int | 生日可见范围，0：保密、1：只显示月日、2：只显示星座、3：所有人可见。 |
| false | string | 用户QQ号码。 | |
| qq_visible | false | int | 用户QQ可见范围，0：自己可见、1：关注人可见、2：所有人可见。 |
| msn | false | string | 用户MSN。 |
| msn_visible | false | int | 用户MSN可见范围，0：自己可见、1：关注人可见、2：所有人可见。 |
| url | false | string | 用户博客地址。 |
| url_visible | false | int | 用户博客地址可见范围，0：自己可见、1：关注人可见、2：所有人可见。 |
| gender | true | string | 用户性别，m：男、f：女，不可为空。 |
| credentials_type | false | int | 证件类型，1：身份证、2：学生证、3：军官证、4：护照。 |
| credentials_num | false | string | 证件号码。 |
| false | string | 用户常用邮箱地址。 | |
| email_visible | false | int | 用户常用邮箱地址可见范围，0：自己可见、1：关注人可见、2：所有人可见。 |
| lang | false | string | 语言版本，zh_cn：简体中文、zh_tw：繁体中文。 |
| description | false | string | 用户描述，最长不超过70个汉字。 |
注意事项
- 填写birthday参数时，做如下约定：
- 只填年份时，请提交年份数据，其余数据置空，或者采用1986-00-00格式；
- 只填月份时，请提交月份数据，其余数据置空，或者采用0000-08-00格式；
- 只填某日时，请提交某日数据，其余数据置空，或者采用0000-00-28格式。
- 当用户生日信息无月日数据，但选择只显示星座时，返回系统默认星座信息
调用样例及调试工具
返回结果
JSON示例
{
"birthday": "null",
"birthday_visible": 3,
"city": 5,
"created_at": "2009-08-28 16:34:24",
"credentials_num": "",
"credentials_type": 0,
"description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
"domain": "zaku",
"email": "weibo@sina.com",
"email_visible": 0,
"gender": "m",
"id": 1404376560,
"lang": "zh_cn",
"location": "北京 朝阳区",
"msn": "",
"msn_visible": 0,
"name": "zaku",
"profile_image_url": "http://tp1.sinaimg.cn/1404376560/30/0/1",
"province": 11,
"qq": "",
"qq_visible": 0,
"real_name": "",
"real_name_visible": 0,
"screen_name": "zaku",
"url": "http://blog.sina.com.cn/zaku",
"url_visible": 2
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| id | int64 | 用户UID |
| name | string | 用户名 |
| screen_name | string | 用户昵称 |
| city | int | 所在城市代码ID |
| province | int | 所在省份代码ID |
| location | string | 所在地信息 |
| created_at | string | 用户创建时间 |
| description | string | 用户描述信息 |
| domain | string | 个性化域名 |
| gender | string | 性别，m：男、f：女 |
| credentials_num | int | 证件号码 |
| credentials_type | int | 证件类型 |
| lang | string | 语言设置 |
| profile_image_url | string | 头像地址 |
| birthday | string | 生日信息 |
| birthday_visible | int | 生日隐私类型，0：保密、1：只显示月日、2：只显示星座、3：所有人可见 |
| string | 联系邮箱地址 | |
| email_visible | int | 邮箱地址隐私类型，0：自己可见、1：我关注人可见、2：所有人可见 |
| msn | string | MSN账号信息 |
| msn_visible | int | MSN账号隐私类型，0：自己可见、1：我关注人可见、2：所有人可见 |
| string | QQ号码 | |
| qq_visible | int | QQ号码隐私类型，0：自己可见、1：我关注人可见、2：所有人可见 |
| real_name | string | 真实姓名 |
| real_name_visible | int | 真实姓名隐私类型，0：自己可见、1：我关注人可见、2：所有人可见 |
| url | string | 用户博客地址 |
| url_visible | int | 用户博客地址隐私类型，0：自己可见、1：我关注人可见、2：所有人可见 |
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
文档更新时间: 2011-06-21
