インスタのすべてのAPIエンドポイントを取得するプログラム方法？

[RGJ (Richard - Communiteq)]

@mcwumbly

では、バックエンドAPIの安定性について、どのような保証ができるでしょうか？

APIドキュメントが 対処すべき 責任だと思います。

APIの安定性に関する保証は、明確なAPIバージョニングによって対処されるべきです。

@mcwumbly

まず、高レベルなメンタルモデルとして、以下のように説明します。

• ドキュメントのメインエントリポイントは、ご指摘の通りこちらです: Documentation - Discourse Meta
• 開発者向けドキュメントは、こちら 、あるいは、むしろこちら: Introduction to Discourse Development です。
• APIドキュメントは開発者向けドキュメントのサブセットであり、こちらにあります: https://docs.discourse.org/

APIドキュメントを 仕様 ではなく ドキュメント と呼びますが、開発者向けドキュメントのサブセットであることには同意します。そのドキュメントのURLは奇妙です…完全なドキュメントがそこにあるか、Documentation - Discourse Meta へのリダイレクトであれば、Introduction to Discourse Development からAPIドキュメントへの明確な案内がある方が理にかなっています。

このトピックは、ドキュメントがどこに存在するかの問題ではなく、APIが どのように ドキュメント化されているかの問題です。不足しているのは、OpenAPIのような標準化された機械可読フォーマットです。

その欠如とバージョニングの欠如により、統合作業は本来よりも困難で脆弱になっています。ドキュメント化されたエンドポイントの基本的なOpenAPIスキーマでさえ、非常に役立つでしょう。