profile API 方法
关于用户账户的方法。
删除账户头像
DELETE /api/v1/profile/avatar HTTP/1.1
返回: CredentialAccount
OAuth: 用户令牌 + write:accounts
版本历史:
4.2.0 - 添加
删除与账户关联的头像。
请求
标头
- Authorization
- 必需 提供此标头，并附带
Bearer <user_token>，以获得对此 API 方法的访问授权。
路径参数
响应
200: OK
已成功从账户中删除头像。若该账户未关联任何头像，响应仍将提示成功删除。
{
"id": "110357222516183152",
"username": "rob",
"acct": "rob",
"display_name": "",
"locked": false,
"bot": false,
"discoverable": false,
"group": false,
"created_at": "2023-05-12T00:00:00.000Z",
"note": "",
"url": "http://localhost:3000/@rob",
"uri": "http://localhost:3000/users/rob",
"avatar": "http://localhost:3000/avatars/original/missing.png",
"avatar_static": "http://localhost:3000/avatars/original/missing.png",
"header": "http://localhost:3000/system/accounts/headers/110/357/222/516/183/152/original/0cd99648c23005ed.png",
"header_static": "http://localhost:3000/system/accounts/headers/110/357/222/516/183/152/original/0cd99648c23005ed.png",
"followers_count": 14,
"following_count": 2,
"statuses_count": 10,
"last_status_at": "2023-06-26",
"noindex": false,
"source": {
"privacy": "public",
"sensitive": false,
"language": null,
"note": "",
"fields": [],
"follow_requests_count": 0
},
"emojis": [],
"roles": [],
"fields": [],
"role": {
"id": "-99",
"name": "",
"permissions": "65536",
"color": "",
"highlighted": false
}
}
401: 未授权
Authorization 标头无效或缺失。
{
"error": "The access token is invalid"
}
删除账户横幅图片
DELETE /api/v1/profile/header HTTP/1.1
返回: CredentialAccount
OAuth: 用户令牌 + write:accounts
版本历史:
4.2.0 - 添加
删除与账户关联的横幅图片。
请求
标头
- Authorization
- 必需 提供此标头，并附带
Bearer <user_token>，以获得对此 API 方法的访问授权。
路径参数
响应
200: OK
已成功从账户中删除横幅图片。若该账户未关联任何横幅图片，响应仍将提示成功删除。
{
"id": "110357222516183152",
"username": "rob",
"acct": "rob",
"display_name": "",
"locked": false,
"bot": false,
"discoverable": false,
"group": false,
"created_at": "2023-05-12T00:00:00.000Z",
"note": "",
"url": "http://localhost:3000/@rob",
"uri": "http://localhost:3000/users/rob",
"avatar": "http://localhost:3000/avatars/original/missing.png",
"avatar_static": "http://localhost:3000/avatars/original/missing.png",
"header": "http://localhost:3000/headers/original/missing.png",
"header_static": "http://localhost:3000/headers/original/missing.png",
"followers_count": 14,
"following_count": 2,
"statuses_count": 10,
"last_status_at": "2023-06-26",
"noindex": false,
"source": {
"privacy": "public",
"sensitive": false,
"language": null,
"note": "",
"fields": [],
"follow_requests_count": 0
},
"emojis": [],
"roles": [],
"fields": [],
"role": {
"id": "-99",
"name": "",
"permissions": "65536",
"color": "",
"highlighted": false
}
}
401: 未授权
Authorization 标头无效或缺失。
{
"error": "The access token is invalid"
}
翻译状态： 本文是英文页面 profile API methods 的翻译，最后翻译时间：2025-04-21，点击这里可以查看翻译后页面的改动。