如何通过REST API修改GitHub当前状态（表情符号）？

REST API 实现方式 #

GitHub 提供了专门的 REST 接口来修改用户状态，具体操作如下：

1. 准备认证凭据
   需要生成一个带 user:write 权限的个人访问令牌（PAT），可在GitHub设置的「Developer settings」→「Personal access tokens」中创建。

2. 发起 PATCH 请求
   接口路径：PATCH /user/status
   请求必须携带认证头 Authorization: token YOUR_PAT，并在请求体中指定状态参数。

3. curl 请求示例

   curl -L \
     -X PATCH \
     -H "Accept: application/vnd.github+json" \
     -H "Authorization: token YOUR_PERSONAL_ACCESS_TOKEN" \
     -H "X-GitHub-Api-Version: 2022-11-28" \
     https://api.github.com/user/status \
     -d '{"message":"正在开发新功能","emoji":":rocket:","expires_at":"2024-12-31T23:59:59Z"}'
   

4. 参数说明

   • message: 可选，状态展示的文本内容
   • emoji: 可选，表情符号的短代码（如:rocket:、:coffee:）
   • expires_at: 可选，状态过期时间，需符合ISO 8601格式（例：2024-12-31T23:59:59Z）
   • limited_availability: 可选布尔值，设为true会将状态标记为「有限可用」

GraphQL 方式补充（中文说明） #

你提到的 ChangeUserStatusInput 输入对象用于GraphQL突变请求，参数说明如下：

• clientMutationId: 可选字符串，用于客户端跟踪突变请求的标识
• emoji: 可选字符串，状态使用的表情符号短代码
• expiresAt: 可选DateTime类型，状态的过期时间
• limitedAvailability: 可选布尔值，设置为true表示用户处于有限可用状态
• message: 可选字符串，状态显示的文本内容

内容的提问来源于stack exchange，提问作者Creeper Saviour