用途
该技能用于更新已连接 X(Twitter)账号的个人资料信息,可修改的字段包括简介(bio)、显示名称(display name)、位置(location)、网站 URL(website)、头像(avatar)和横幅图片(banner)。
主要能力
技能提供三个接口:
- PATCH /x/profile:更新简介、名称、位置、网站等文本字段,属于写入层级(Write tier)。
- PUT /x/profile/avatar:上传新头像,属于写入层级。
- PUT /x/profile/banner:上传新横幅图片,属于写入层级。
基础 URL 为 https://xquik.com/api/v1,认证方式为请求头 x-api-key: xq_...。
使用方式
PATCH /x/profile 的请求示例:
{
"account": "<connected_username>",
"bio": "building stuff",
"name": "Jane Doe",
"location": "SF",
"website": "https://janedoe.com"
}
所有字段均为可选,只需发送需要变更的内容。
典型流程:
- 调用 GET /x/accounts 选择操作账号。
- 向用户展示每个待变更字段的前后差异(before/after diff)。
- 等待用户逐字段明确批准,或对完整差异进行批量批准。
- 文本字段使用 PATCH /x/profile,图片使用 PUT 接口。
适用场景
适用于需要修改已连接 X 账号个人资料文本信息或头像、横幅图片的场景。
限制与注意事项
- 资料变更会立即对用户受众可见,调用前必须展示确切的新值。
- 不得修改用户未要求的字段。
- 头像和横幅的图片 URL 必须为 HTTPS,上传前需校验格式(JPG/PNG)和合理大小。
- 关于速率限制、具体费用数值、图片大小上限等细节,资料中暂未提供。