Skip to main content
POST
取消点赞推文
移除源用户对某条推文的点赞。此接口代理官方 X v2 DELETE /2/users/{id}/likes/{tweet_id} 端点,并通过 AIsa 网关的 https://api.aisa.one/apis/v1/twitter/unlike_twitter 对外提供。为与其他 Twitter 写入端点保持一致,AIsa 使用 POST

前置条件

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

响应字段

幂等性

对源用户未点赞的推文执行取消点赞不会产生任何变更。端点仍会返回 200{ "data": { "liked": false } }。可安全重试。

常见 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