Skip to main content
POST
点赞推文
代表已验证身份的源用户为推文点赞。此端点代理官方 X v2 POST /2/users/{id}/likes 端点,并通过位于 https://api.aisa.one/apis/v1/twitter/like_twitter 的 AIsa 网关路由。

前提条件

  • 一个 AIsa API 密钥(每个请求都使用 Bearer token)。
  • 源用户账户的一次性 OAuth 授权。调用 POST /apis/v1/twitter/auth_twitter 关联您的 X 账户——AIsa 会将会话与您的 API 密钥关联存储,并在每次写入调用中自动使用该会话。
  • X 会话必须拥有 like.writetweet.readusers.read 权限范围。

响应字段

幂等性

如果源用户已为某条推文点赞,再次点赞不会产生任何操作。端点仍会返回 200{ "data": { "liked": true } }。可以安全重试。

常见 4xx 原因

  • 400 invalid-request — 缺少 tweet_id 或其值不是数字
  • 403 client-forbidden — OAuth 会话缺少 like.write 权限范围。请通过 auth_twitter 重新关联。
  • 404 resource-not-found — 推文不存在或对源用户不可见(例如,源用户未关注的受保护账户)。
更多信息请参阅错误代码速率限制

相关内容

关联 X 账户

启动此端点所需的 OAuth 流程。

发布推文

创建您(或您的智能体)可以点赞的推文。

关注用户

使用同一 OAuth 会话的另一个写入端点。

授权

Authorization
string
header
必填

你的 AIsa API 密钥。经过身份验证的源用户(执行关注操作的账户)由附加到你的密钥的 OAuth 会话决定。

请求体

application/json
tweet_id
string
必填

要点赞的推文数字 ID。必须匹配 X 的正则表达式 ^[0-9]{1,19}$

Pattern: ^[0-9]{1,19}$
示例:

"1346889436626259968"

响应

点赞成功(或已点赞)。

data
object