Đến nội dung
X-Buddy
English

Tra cứu API

Đọc yêu cầu theo dõi đang chờ

x_read_follow_requests — People waiting for the account to accept their follow request (only a protected account gets them): X's own id list plus the handles the page showed.

Bản Markdown

x_read_follow_requests · Đọc trực tiếp trên X (tạo việc)

Mô tả kỹ thuật bằng tiếng Anh — đúng chữ AI agent đọc qua MCP.

People waiting for the account to accept their follow request (only a protected account gets them): X's own id list plus the handles the page showed. Counts as a sync read.
REST POST /api/public/v1/accounts/{account}/reads/follow-requests
Công cụ MCP x_read_follow_requests
Quyền cần có accounts.run — Chủ, Quản lý, Vận hành
Nhóm quyền x:read
Nhóm Đọc trực tiếp trên X
Hiện sẵn trong hồ sơ Điều khiển nick

Đầu vào

Trường Kiểu Bắt buộc Mô tả
account string (1–100 chars) Có The X account to use: its X-Buddy account_id (from account_list) or its @handle. Ambiguous names return candidates instead of guessing.
max integer (1–1000) Không Most requests to read.

Kết quả

Tạo một việc cho VPS của nick. REST chờ tối đa wait giây (mặc định 15, tối đa 20): xong thì trả 200 với kết quả, chưa xong thì trả 202 kèm Location: /api/public/v1/jobs/{job_id}. Kết quả cuối có thể là succeeded, failed, cancelled hoặc unknown.

Ví dụ

Gọi qua REST

curl -X POST "https://reach-link-craft.lovable.app/api/public/v1/accounts/%40your_x_account/reads/follow-requests" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "x_read_follow_requests",
    "arguments": {
      "account": "@your_x_account"
    }
  }
}

Lỗi có thể gặp

Mã HTTP Thử lại được
unauthorized 401 Không
key_expired 401 Không
integration_revoked 401 Không
connection_not_linked 403 Không
integration_paused 403 Không
workspace_integrations_paused 403 Không
integration_authorization_lost 403 Không
workspace_suspended 403 Không
forbidden 403 Không
invalid_input 422 Không
rate_limited 429 Có
internal 500 Có
ambiguous_account 409 Không
account_not_allowed 403 Không
not_found 404 Không
agent_too_old 422 Không
unsupported_by_account 422 Không

Về danh sách thao tác