Skip to main content
POST
Reference example
移除源用户对某条推文的点赞。此接口代理官方 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.write、tweet.read、users.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 会话的写入端点。

费用与请求规则

公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.01
  • 计费依据: fixed_success
  • 公开参考倍率: 1.0
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
tweet_id
string
必填

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

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

"1346889436626259968"

响应

取消点赞成功(或者源用户原本就没有点赞该推文)。

data
object