用途:在任意 Mastodon 实例上发布、删除和读取自己的嘟文(toot)。凭据由连接器注入:$MASTODON_BASE_URL(实例地址,如 https://mastodon.social)与 $MASTODON_ACCESS_TOKEN,每个请求都带 Authorization: Bearer $MASTODON_ACCESS_TOKEN 头。
主要能力:先用 GET $MASTODON_BASE_URL/api/v1/accounts/verify_credentials 确认令牌与账号,并取得账号 id;用 POST $MASTODON_BASE_URL/api/v1/statuses 发布嘟文,可带 visibility(public、unlisted、private、direct)、spoiler_text、in_reply_to_id、sensitive、language 等参数,建议加 Idempotency-Key 防重复;用 GET $MASTODON_BASE_URL/api/v1/accounts/$ACCT_ID/statuses 列出近期嘟文与互动数据(limit 最大 40,可加 exclude_replies、exclude_reblogs、only_media、pinned、tagged 等过滤);用 DELETE $MASTODON_BASE_URL/api/v1/statuses/STATUS_ID 删除嘟文。媒体可先 POST $MASTODON_BASE_URL/api/v2/media 上传取得 media id,再以 media_ids[] 附带。
使用方式:以 curl + jq 调用,文本用 --data-urlencode 编码。发布前需与用户确认,默认 visibility 为 unlisted,仅在用户要求时用 public。
限制:错误以 JSON {"error":"<message>"} 返回,应原样展示;401 表示令牌无效或已撤销,需重新连接;403 表示缺少 scope(读取需 read,发布/删除需 write 或 write:statuses);默认字数上限 500(实例可配置),超长返回 422;API 只针对用户自己的实例,令牌不能跨实例使用;有速率限制,批量发布需间隔以免 429;verify_credentials 的 note 等字段含 HTML,纯文本在 source 对象中。