> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 点赞推文

> 代表已认证的源用户为推文点赞。通过 AIsa 网关代理官方 X v2 like-post 端点。

代表已验证身份的源用户为推文点赞。此端点代理官方 [X v2 `POST /2/users/{id}/likes` 端点](https://docs.x.com/x-api/users/like-post)，并通过位于 `https://api.aisa.one/apis/v1/twitter/like_twitter` 的 AIsa 网关路由。

## 前提条件

* 一个 **AIsa API 密钥**（每个请求都使用 Bearer token）。
* 源用户账户的一次性 **OAuth 授权**。调用 [`POST /apis/v1/twitter/auth_twitter`](/zh/api-reference/twitter/post_twitter-auth-twitter) 关联您的 X 账户——AIsa 会将会话与您的 API 密钥关联存储，并在每次写入调用中自动使用该会话。
* X 会话必须拥有 `like.write`、`tweet.read`、`users.read` 权限范围。

## 响应字段

| 字段           | 类型      | 含义                   |
| ------------ | ------- | -------------------- |
| `data.liked` | boolean | 源用户为目标推文点赞后为 `true`。 |

## 幂等性

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

## 常见 4xx 原因

* `400 invalid-request` — 缺少 `tweet_id` 或其值不是数字
* `403 client-forbidden` — OAuth 会话缺少 `like.write` 权限范围。请通过 `auth_twitter` 重新关联。
* `404 resource-not-found` — 推文不存在或对源用户不可见（例如，源用户未关注的受保护账户）。

更多信息请参阅[错误代码](/zh/api-reference/errors)和[速率限制](/zh/api-reference/rate-limits)。

## 相关内容

<CardGroup cols={3}>
  <Card title="关联 X 账户" icon="key" href="/zh/api-reference/twitter/post_twitter-auth-twitter">
    启动此端点所需的 OAuth 流程。
  </Card>

  <Card title="发布推文" icon="pen" href="/zh/api-reference/twitter/post_twitter-post-twitter">
    创建您（或您的智能体）可以点赞的推文。
  </Card>

  <Card title="关注用户" icon="user-plus" href="/zh/api-reference/twitter/post_twitter-follow-twitter">
    使用同一 OAuth 会话的另一个写入端点。
  </Card>
</CardGroup>


## OpenAPI

````yaml openapi/zh/twitter-actions.json POST /twitter/like_twitter
openapi: 3.0.3
info:
  title: Twitter Actions API
  version: 1.0.0
  description: >-
    对 X/Twitter 执行写入操作，并通过 AIsa 网关路由。参照官方 X v2 API 端点建模（例如 POST
    /2/users/{id}/following）。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /twitter/like_twitter:
    post:
      summary: 点赞推文
      description: >-
        代表已认证的源用户点赞推文。此接口映射[官方 X v2 `POST /2/users/{id}/likes`
        端点](https://docs.x.com/x-api/users/like-post)，并通过 AIsa 网关路由。


        **身份验证。**需要源用户的 OAuth 会话，并将其关联到您的 AIsa API 密钥。通过 `POST
        /apis/v1/twitter/auth_twitter` 关联一次账户即可。


        **权限范围。**底层 X 会话必须具有 `like.write`、`tweet.read` 和 `users.read` 权限。


        点赞已点赞的推文不会执行任何操作，但仍会返回 `200` 和 `liked: true`。
      operationId: likeTwitter
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - tweet_id
              properties:
                tweet_id:
                  type: string
                  description: 要点赞的推文数字 ID。必须匹配 X 的正则表达式 `^[0-9]{1,19}$`。
                  pattern: ^[0-9]{1,19}$
                  example: '1346889436626259968'
            examples:
              like_tweet:
                summary: Like tweet 1346889436626259968
                value:
                  tweet_id: '1346889436626259968'
      responses:
        '200':
          description: 点赞成功（或已点赞）。
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      liked:
                        type: boolean
                        description: 源用户点赞目标推文后为 `true`。
              example:
                data:
                  liked: true
        '400':
          description: 请求无效 — 缺少 `tweet_id` 或其格式不正确。
        '401':
          description: AIsa API 密钥缺失或无效。
        '403':
          description: >-
            OAuth 会话缺失、已过期或缺少 `like.write` 权限。请通过 `POST
            /apis/v1/twitter/auth_twitter` 重新授权。
        '404':
          description: 未找到推文，或该推文对源用户不可见。
        '429':
          description: 已触发速率限制——可能是您的 AIsa 密钥达到 RPM 上限，或上游 X 触发速率限制。
        '500':
          description: 内部错误。
        '502':
          description: 无法访问上游 X API。可安全地使用指数退避进行重试。
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key
      description: 你的 AIsa API 密钥。经过身份验证的源用户（执行关注操作的账户）由附加到你的密钥的 OAuth 会话决定。

````