相互のみ公開API - kmycode/mastodon GitHub Wiki

kmyblueでは独自の公開範囲「相互のみ」があります。これは限定投稿の一種であり、他の公開範囲とは異なる判別が必要になります。

対応可否の判定方法

下記のエンドポイントで取得できるJSONについて

/api/v1/instance
/api/v2/instance

下記の配列に値があるかで判定してください

{
  "fedibird_capabilities": [
    "visibility_mutual",
    "kmyblue_limited_scope"
  ]
}

Fedibird互換情報

このAPIはFedibirdの相互フォロー限定と互換性があります。

• 【23/8現在】Fedibirdはlimited_scopeをサポートしません
• 【23/8現在】FedibirdではPOST /api/v1/statusesによる投稿の時の戻り値にcircle_idが含まれますが、kmyblueでは含まれません

既存のオブジェクトに追加されたプロパティ

Statusオブジェクトにlimited_scopeプロパティが追加されています。相互限定投稿であるかは、visibilityがlimited、かつlimited_scopeがmutualになっているかで判別してください。

投稿

投稿APIを呼び出す場合、JSONの以下のプロパティに追加で指定できる値があります。mutualを指定することで、その投稿は「相互のみ」になります。ただしこのAPIの戻り値では、visibilityはlimitedになることに留意してください。

{
  "visibility": "mutual"
}

戻り値では以下の値が設定されます。

{
  "visibility": "limited",
  "limited_scope": "mutual"
}