swagger-cli validateがvalidとなるapi.jsonを作れるようにしたい

[samunohito]

（機能要望でもバグ報告でもないので、空のテンプレートで失礼します）

概要

Misskey本体にはOpenAPI形式のjsonを作成する機能が備わっており、実際に型やクライアントの自動生成ツールに読み込ませて使用できます。しかし、同時に以下の問題点を抱えています。

1. 書式的には完全な状態ではなくswagger-cli validateにて解析すると大量の警告が出る
2. 認証が必要なエンドポイントにおいて、トークンをもたせるiを含んだ形でエンティティを作れない

これらはユーザに直接影響のあるものではありませんが、サードパーティアプリの開発者にとっては以下の点が懸念になると思います。

1. OpenAPIに対応した生成ツールによっては生成時に警告が出そう
   →もし思い通りに作られない箇所があった時、原因の特定が大変になる可能性（警告が多いので）
2. iを持たせるには一度any化するか（js/tsの場合）、オブジェクトをラップするか（java、C#など）などの細工が必要になる

などの点が考えられます。

対象ユーザ

Misskeyから生成したapi.jsonを使用する開発者各位

[samunohito]

実装は自分がします。

[samunohito]

マージ感謝:pray: