/api.json が OpenAPI Specification として invaild な部分がある

[zyoshoka]

💡 Summary

現在バックエンドの生成する OpenAPI 定義 /api.json は validate-api-json ワークフローによって validate され見かけ上通ってはいますが、ログを見ると 156 個の警告が出力されています（https://github.com/misskey-dev/misskey/actions/runs/7927440397/job/21643840936 の Validation を参照）。

これらの警告は、下記のコマンドで --extends=minimal オプションを取っ払うと153個のエラーと4個の警告に変わるため、対処すべきであると考えられます。

misskey/.github/workflows/validate-api-json.yml

Line 47 in 2744cbd

run: npx @redocly/cli lint --extends=minimal ./packages/backend/built/api.json

警告の殆どを占めているのは次の2つです：

• operation-operationId-unique (related: api-docにapi/emojisとapi/emojiがそれぞれ2つずつある #12640 (comment) fix(backend): 虚無ノートを投稿できる問題の修正と api.json の OpenAPI Specification 3.1.0 への対応 #12969 (comment))
• security-defined

（タイトルだけ見れば #10632 と同じですが内容が異なるので別で立てます）

🥰 Expected Behavior

pnpm --filter backend generate-api-json && redocly lint packages/backend/built/api.json でエラーが出ない

🤬 Actual Behavior

pnpm --filter backend generate-api-json && redocly lint packages/backend/built/api.json でエラーが出る（--extends=minimal 付きだとエラーは出ない）

📝 Steps to Reproduce

No response

💻 Frontend Environment

No response

🛰 Backend Environment (for server admin)

* Installation Method or Hosting Service:
* Misskey: 2023.3.0
* Node:
* PostgreSQL:
* Redis:
* OS and Architecture:

Do you want to address this bug yourself?

• Yes, I will patch the bug myself and send a pull request

[zyoshoka]

security-defined ルールのエラーは単に

security: [{
	bearerAuth: [],
}],

を追加すれば解消されるようです。

operation-operationId-unique ルールのエラーは allowGet が true なエンドポイントのみで生じているので get- / post- などの prefix をつければ直りそうです（それがベスト・プラクティスかどうかは分かりませんが…）