Table of Contents
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
背景
- 投稿の最大文字数、HTLの最大長、添付メディアのサイズなど、クライアントアプリには公開されない情報が色々とある。
- 投稿の最大文字数は max_toot_chars で参照できるようにするサーバがある。公式にもPRが送られたがリジェクトされた。https://github.com/tootsuite/mastodon/pull/5697
- https://github.com/tootsuite/mastodon/issues/4915 の議論の中でぬるかる氏がクライアントアプリから参照できる機能リストというアイデアを出していた。
feature_quote
- 公式ドキュメント： https://scrapbox.io/fedibird-guide/feature_quote
- fedibird_capabilitiesの外側にある項目。
feature_quote: trueの場合は引用トゥートを作成できる。
fedibird_capabilities
2021年2月11日、fedibird.comの/api/v1/instance にfedibird_capabilitiesが追加された。
クライアントアプリから参照できる機能リストが用意されたので、アプリはどの機能をユーザに見せるべきか判断しやすくなる。
favourite_hashtag
お気に入りハッシュタグ機能。(公式ドキュメント不明)
- ユーザ設定の https://fedibird.com/settings/favourite_tags でハッシュタグを追加する
- 公式WebUIのサイドメニューにそのタグの項目が表示されて、タグTLを開きやすくなる。
- GET https://fedibird.com/api/v1/favourite_tags
- 認証が必要
レスポンス例
[
{
"id": "249",
"name": "subwaytooter",
"updated_at": "2021-02-11T21:24:00.829Z"
},
{
"id": "250",
"name": "android",
"updated_at": "2021-02-11T21:24:06.550Z"
},
{
"id": "251",
"name": "fedibird",
"updated_at": "2021-02-11T21:24:12.111Z"
}
]
favourite_domain
お気に入りドメイン機能。(公式ドキュメント不明)
- ユーザ設定の https://fedibird.com/settings/favourite_domains でAPドメインを追加する
- 公式WebUIのサイドメニューにその項目が表示されて、ドメインTLを開きやすくなる。
- GET https://fedibird.com/api/v1/favourite_domains
- 認証が必要
レスポンス例
[
{
"id": "224",
"name": "mastodon.juggler.jp",
"updated_at": "2021-02-11T21:28:33.771Z"
}
]
status_expire
投稿に特定のハッシュタグを追加することで、時間経過により投稿を自動的に削除する機能。
- 公式ドキュメント： 不明
- 公式WebUIにも関連UIはない。APIもない。
follow_no_delivery
- 公式ドキュメント： 不明
- Relationship entity に delivery_following:false が見られる。
詳細不明。
follow_hashtag
ユーザ設定画面で購読したらホームやリストに流せる機能。
- 公式ドキュメント https://scrapbox.io/fedibird-guide/%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5%E3%82%BF%E3%82%B0%E3%81%AE%E3%83%95%E3%82%A9%E3%83%AD%E3%83%BC
- ユーザ設定 https://fedibird.com/settings/follow_tags
フォローとなっているが購読機能の一つらしい。
クライアントアプリで対応できることは特にないと思う。 管理UIはAPIではなく設定画面だし、作用はホームやリストTLの内容が変わるだけ。
subscribe_account
連合タイムラインの投稿をユーザで抽出してホームやリストに流す機能。
- 公式ドキュメント： https://scrapbox.io/fedibird-guide/%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%81%AE%E8%B3%BC%E8%AA%AD
- 設定画面 https://fedibird.com/settings/account_subscribes
WebUIのアカウント詳細からも設定できる。
- POST https://fedibird.com/api/v1/accounts/58/subscribe
- POST https://fedibird.com/api/v1/accounts/58/unsubscribe
現在の購読状態はRelationship entityに以下の項目が追加される。
"account_subscribing":{
"-1": {
"reblogs":true
}
}
-1は何だろう…？
subscribe_domain
- ユーザ設定画面で購読したらホームやリストに流せる機能。
- 公式ドキュメント https://scrapbox.io/fedibird-guide/%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E3%81%AE%E8%B3%BC%E8%AA%AD
- ユーザ設定 https://fedibird.com/settings/domain_subscribes
クライアントアプリで対応できることは特にないと思う。 管理UIはAPIではなく設定画面だし、作用はホームやリストTLの内容が変わるだけ。
subscribe_keyword
- ユーザ設定画面で購読したらホームやリストに流せる機能。
- 公式ドキュメント https://scrapbox.io/fedibird-guide/%E3%82%AD%E3%83%BC%E3%83%AF%E3%83%BC%E3%83%89%E3%81%AE%E8%B3%BC%E8%AA%AD
- ユーザ設定 https://fedibird.com/settings/keyword_subscribes
クライアントアプリで対応できることは特にないと思う。 管理UIはAPIではなく設定画面だし、作用はホームやリストTLの内容が変わるだけ。
timeline_no_local
- 公式ドキュメント: https://scrapbox.io/fedibird-guide/timeline_no_local
- ローカルタイムラインを無効にしている場合、fedibird_capabilitiesに"timeline_no_local"が列挙されます。
timeline_domain
- ドメインタイムライン機能。(ユーザではなく)リモートの投稿のmoreメニューからTLを開ける。
- 公式ドキュメント: https://fedibird.com/@info/103266777365961665
- ユーザ設定: 不明。
- APIは認証不要。
timeline_group
- 公式ドキュメント https://fedibird.com/users/noellabo/statuses/104518924656387896
- ユーザの代わりにグループにメンションすると、そのグループをフォローしている人たちに投稿が送られる。
timeline_group_directory
- グループディレクトリの表示。
- WebUI https://fedibird.com/web/group_directory
- GET https://fedibird.com/api/v1/group_directory?order=active&limit=20
visibility_mutual
「相互フォロー」公開範囲を利用できる。
-
投稿時にvisibilityに"mutual"を指定する。作成された投稿のvisibilityは"limited"に変化するのがトリッキーなところ。circle_id が追加される。送り先を後から確認するのは/api/v1/statuses/{status_id}/mentioned_by で行う。返信する時はvisibility:limited,circle_id:nullで同じ送信先が維持される。
-
visibility:"limit"の場合、返信元投稿のcircle_idがnullかどうかでサークル選択肢の表記が変わる？
visibility_limited
「限定」公開範囲を利用できる。
- 投稿時に
visibility:"limited",circle_id:xxxを指定する必要がある。 - WebUIではサークルを指定しないと投稿できない。
emoji_reaction
絵文字リアクション機能。 see also https://github.com/tateisu/SubwayTooter/wiki/Nightly-Fedibird-%E3%81%AE%E7%B5%B5%E6%96%87%E5%AD%97%E3%83%AA%E3%82%A2%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3%E6%A9%9F%E8%83%BD