更新个人信息

修改当前登录账号的资料（昵称/别名/性别/电话/邮箱/小程序名片地址）。

请求参数

参数	必填	类型	说明
appid	是	string	实例 appid，标识操作哪个已登录账号。示例：we_xxxxxxxxxxxxxxx
gender	至少填一个	int64	1 男 / 2 女。示例：1
name	至少填一个	string	姓名。示例：哈哈哈
alias	至少填一个	string	别名。示例：测试下
phone	至少填一个	string	电话（外部对象常为空）。示例：12313-1231
xcxCorpAddress	至少填一个	string	小程序名片-企业地址，base64 编码（如 5rWZ5rGf5aSn5aSP...→「浙江大夏...」）。示例：浙江大夏
email	至少填一个	string	邮箱。示例：903809901@qq.com

请求示例

HTTP

POST {BASE_URL}/wx-api/api/personal/updateInfo
Authorization: Bearer <你的 App Token>
Content-Type: application/json

{
  "appid": "we_xxxxxxxxxxxxxxx",
  "gender": 1,
  "name": "哈哈哈",
  "alias": "测试下",
  "phone": "12313-1231",
  "xcxCorpAddress": "浙江大夏",
  "email": "903809901@qq.com"
}

curl

curl -X POST '{BASE_URL}/wx-api/api/personal/updateInfo' \
  -H 'Authorization: Bearer <你的 App Token>' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "appid": "we_xxxxxxxxxxxxxxx",
  "gender": 1,
  "name": "哈哈哈",
  "alias": "测试下",
  "phone": "12313-1231",
  "xcxCorpAddress": "浙江大夏",
  "email": "903809901@qq.com"
}'

Python

import requests

url = "{BASE_URL}/wx-api/api/personal/updateInfo"
headers = {"Authorization": "Bearer <你的 App Token>", "Content-Type": "application/json"}
body = """{
  "appid": "we_xxxxxxxxxxxxxxx",
  "gender": 1,
  "name": "哈哈哈",
  "alias": "测试下",
  "phone": "12313-1231",
  "xcxCorpAddress": "浙江大夏",
  "email": "903809901@qq.com"
}"""

resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String url = "{BASE_URL}/wx-api/api/personal/updateInfo";
String body = "{\n" +
    "  \"appid\": \"we_xxxxxxxxxxxxxxx\",\n" +
    "  \"gender\": 1,\n" +
    "  \"name\": \"哈哈哈\",\n" +
    "  \"alias\": \"测试下\",\n" +
    "  \"phone\": \"12313-1231\",\n" +
    "  \"xcxCorpAddress\": \"浙江大夏\",\n" +
    "  \"email\": \"903809901@qq.com\"\n" +
    "}";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的 App Token>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

PHP

<?php

$url = '{BASE_URL}/wx-api/api/personal/updateInfo';
$body = <<<'JSON'
{
  "appid": "we_xxxxxxxxxxxxxxx",
  "gender": 1,
  "name": "哈哈哈",
  "alias": "测试下",
  "phone": "12313-1231",
  "xcxCorpAddress": "浙江大夏",
  "email": "903809901@qq.com"
}
JSON;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <你的 App Token>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

响应示例

解析响应前确认字段

返回字段见个人信息模块总览。完整响应格式及未列出的字段，请通过开通与支持联系对接人确认后再解析。

响应字段

字段	类型	说明
code	int64	统一封套状态码：0=成功，负数=失败
detail	string	附加明细，通常为空
message	string	文案：成功为 ok；失败形如 -码|描述
time	string	服务端处理时间 YYYY-MM-DD HH:MM:SS

下一步

• 个人信息模块总览
• 错误码
• 快速开始