api-docにapi/emojisとapi/emojiがそれぞれ2つずつある

[1673beta]

💡 Summary

api-doc中にemojisとemojiがPOSTとGETの2つずつある。
検索をかけるとなぜかどっちもGETメソッドとして表示される。
画像はkoliosky.comでemojiで検索をかけたもの。

🥰 Expected Behavior

1つずつ(のはず)

🤬 Actual Behavior

2つ以上ずつある

📝 Steps to Reproduce

1. api-docを開く
2. なんか増えてる
3. emojiあるいはemojisで検索をかけると画像のようになる

💻 Frontend Environment

* Model and OS of the device(s):
* Browser:
* Server URL: koliosky.com, misskey.systems
* Misskey: 2023.12.0-beta.3

🛰 Backend Environment (for server admin)

* Installation Method or Hosting Service: systemd
* Misskey: 2023.12.0-beta.3
* Node: 20.5.1
* PostgreSQL: 16
* Redis: 7.2.3
* OS and Architecture: Ubuntu 22.0.4 LTS

[kakkokari-gtyih]

api.jsonではちゃんと1つずつ出ているのでビューワー側の問題かも

[Lumisilk]

別の質問というか、例えば /emojis は POST と GET 両方存在しているのはなぜでしょうか… 返り値が同じなのに。
この問題で両者の OpenAPI の operation ID が被っていて、OpenAPI 3.1 の仕様に反しているはず。

それとも今の Misskey API は OpenAPI 使わず、他に新設のなにかを使う方向ですか…？

（バックエンドにあまり詳しくなくて何か間違えたらすみません）

[anatawa12]

GETとPOST両方あるのは

• MisskeyのAPIは原則POST
• 例外的に一部APIはブラウザ等キャッシュを効かせるためGETも受け付ける

という仕様のはずです

[Sayamame-beans]

triage: 現状仕様なのでclose…?

[samunohito]

この問題で両者の OpenAPI の operation ID が被っていて、OpenAPI 3.1 の仕様に反しているはず。

これは直すべきだと考えているので、openのままでお願いします 🙏
（手が回ってない）

[samunohito]

ああ、でも… #13498 に包括できるかも…？

[zyoshoka]

少なくとも本 issue の本題である

api-doc中にemojisとemojiがPOSTとGETの2つずつある。
検索をかけるとなぜかどっちもGETメソッドとして表示される。

については #14152 にて直っているようですので close します。OpenAPI Specification に沿っていない問題に関しては #13498 にまとめましょう