跳转到主要内容
POST
https://api.aisa.one/apis/v1
/
twitter
/
unlike_twitter
取消点赞推文
curl --request POST \
  --url https://api.aisa.one/apis/v1/twitter/unlike_twitter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tweet_id": "1346889436626259968"
}
'
import requests

url = "https://api.aisa.one/apis/v1/twitter/unlike_twitter"

payload = { "tweet_id": "1346889436626259968" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({tweet_id: '1346889436626259968'})
};

fetch('https://api.aisa.one/apis/v1/twitter/unlike_twitter', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/twitter/unlike_twitter",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tweet_id' => '1346889436626259968'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://api.aisa.one/apis/v1/twitter/unlike_twitter"

payload := strings.NewReader("{\n \"tweet_id\": \"1346889436626259968\"\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/twitter/unlike_twitter")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"tweet_id\": \"1346889436626259968\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/twitter/unlike_twitter")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tweet_id\": \"1346889436626259968\"\n}"

response = http.request(request)
puts response.read_body
{
  "data": {
    "liked": false
  }
}
移除源用户对某条推文的点赞。此接口代理官方 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 权限范围。

响应字段

字段类型含义
data.likedboolean点赞移除后为 false。即使源用户最初并未点赞该推文,也会返回 false——取消点赞操作具有幂等性。

幂等性

对源用户未点赞的推文执行取消点赞不会产生任何变更。端点仍会返回 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