Tra cứu API

Trả lời bài

post_reply — Reply to a post as the account with exactly this text (sent word for word, never rewritten), optionally with up to 4 images or 1 video / GIF from media_create_upload (agent 1.14.0+).

Bản Markdown

post_reply · Ghi lên X (tạo việc)

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

Reply to a post as the account with exactly this text (sent word for word, never rewritten), optionally with up to 4 images or 1 video / GIF from media_create_upload (agent 1.14.0+). Stops if the post author is on the do-not-contact list. Counts against Reply.


REST	`POST /api/public/v1/accounts/{account}/actions/reply`
Công cụ MCP	`post_reply`
Quyền cần có	`accounts.run` — Chủ, Quản lý, Vận hành
Nhóm quyền	`x:engage`
Nhóm	Thao tác 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.
`post`	string (1–300 chars)	Có	Post id (digits) or its URL, e.g. https://x.com/someone/status/1790000000000000000
`text`	string (1–4000 chars)	Có	Reply text, sent as is.
`media_ids`	array of string (0–500 chars) (0–4 items)	Không	Up to 4 images or 1 video / GIF: media_id values returned by media_create_upload (purpose=post).

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.

Cần khoá idempotency (Idempotency-Key, 8–128 ký tự). Gửi lại cùng khoá không bao giờ làm lại việc.

Thao tác này xoá dữ liệu hoặc không hoàn tác được. Hỏi lại người dùng trước khi gọi.

Việc kết thúc unknown có thể đã xảy ra trên X: không gửi lại bằng khoá idempotency mới.

Ví dụ

Gọi qua REST

curl -X POST "https://reach-link-craft.lovable.app/api/public/v1/accounts/%40your_x_account/actions/reply" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H "Content-Type: application/json" \
  -d '{"post":"1790000000000000000","text":"Hello from X-Buddy"}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "post_reply",
    "arguments": {
      "account": "@your_x_account",
      "post": "1790000000000000000",
      "text": "Hello from X-Buddy",
      "idempotency_key": "6f1c2a90-example-key"
    }
  }
}

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ó
`read_only`	403	Không
`idempotency_key_required`	428	Không
`idempotency_conflict`	409	Không
`idempotency_processing`	409	Có
`conflict`	409	Không
`precondition_failed`	422	Không
`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

Trả lời bài

#Đầu vào

#Kết quả

#Ví dụ

#Gọi qua REST

#Gọi qua MCP