Tra cứu API

Gửi bài qua tin nhắn

dm_share_post — Send a post to a person in a DM, like X's 'Send via Chat': the message is the optional comment word for word, then the post's link on its own line (X shows it as the post card).

Bản Markdown

dm_share_post · 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.

Send a post to a person in a DM, like X's 'Send via Chat': the message is the optional comment word for word, then the post's link on its own line (X shows it as the post card). Into an existing conversation (thread_id) or to a person by @handle; same X Chat passcode, do-not-contact and DM limits as dm_send.


REST	`POST /api/public/v1/accounts/{account}/actions/share-post`
Công cụ MCP	`dm_share_post`
Quyền cần có	`inbox.reply` — Chủ, Quản lý, Vận hành
Nhóm quyền	`inbox:send`
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
`thread_id`	string (uuid)	Không	X-Buddy conversation id (inbox_list_threads).
`person`	string (1–60 chars)	Không	Send to this person (starts or continues the conversation).
`text`	string (0–9000 chars)	Không	Optional comment sent before the link, as is.

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/share-post" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H "Content-Type: application/json" \
  -d '{"post":"1790000000000000000"}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "dm_share_post",
    "arguments": {
      "account": "@your_x_account",
      "post": "1790000000000000000",
      "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

Gửi bài qua tin nhắn

#Đầu vào

#Kết quả

#Ví dụ

#Gọi qua REST

#Gọi qua MCP