I don’t understand why full documentation for all API endpoints doesn’t exist. The original documentation was released to the public on December 2014, and here we are 6 years later and the documentation is still half-baked. Why is this? The lack of good documentation and the suggestion to reverse-e…

Can you give some examples as to what you’re having trouble with or finding lacking?

This is a timely topic because I have a warning on my forum. “We detected an API request using a deprecated authentication method.” I would like to know the current method I should be using, and a how-to guide to implement it from the forum admin POV. What I’ve found are dated threads that link to…

Proper API authentication is covered in the docs, right at the top. In short, you need to use HTTP Headers to provide the API key and username instead of URL parameters.

@justin My specific example is I’m slowly working on rolling out a Discourse API Python wrapper, and I find the lack of proper documentation overwhelming. I already have to hand-test every single endpoint, but many of those endpoints are either not documented or are incorrectly documented. It’s dir…

See How to reverse engineer the Discourse API Why isn’t every grain of sand on a beach “fully documented”? :rofl:

Out of interest why don’t you simply support what is required until you hit a new unsupported requirement at which point reverse engineer it? That’s a lot easier than aiming for 100% and it’s pointless wrapping calls that will never get used? Especially since you will be supporting a moving target…

I understand that this can be reverse-engineered. It’s just a little frustrating to have to do this. The API was created by humans who must know how it works, why can’t those humans write it down so others can be informed? I don’t feel like this is a big ask. Good documentation is crucial in any pr…

That’s the plan right now, I’ve got every documented endpoint mirrored on my repo right now in the develop branch, and I’ve come to the point where I’m going to have to start reverse-engineering. I’m already starting to contribute to GitHub - discourse/discourse_api_docs: Discourse API Documentatio…

[画像] samamorgan: I’m really just questioning why this is even necessary on such an established project. As with anything, it’s a matter of resources and priority. The API surface is huge. Technically, it’s everything - everything is accessed via the API, hence why reverse engineering works. W…

Discourse API のドキュメントが完全ではないのはなぜですか？

開発

codinghorror (Jeff Atwood) 2020 年 1 月 12 日午前 12:35 10

Reverse engineer the Discourse API をご覧ください

なぜビーチのすべての砂粒が「完全に文書化」されていないのでしょうか？

「いいね！」 4

トピック		返信	表示
Programmatic way to get all API endpoints for my instance? Development rest-api	11	536	2025 年 4 月 24 日
Contributing to the Discourse API documentation Contributing rest-api , how-to	4	3239	2024 年 4 月 2 日
Swagger, WADL or similar for the REST API? Development	10	14710	2016 年 8 月 30 日
What is the Timing of Formal Discourse REST API? Feature	6	2413	2025 年 12 月 4 日
A New Python API Development	2	2315	2021 年 9 月 30 日

Discourse API のドキュメントが完全ではないのはなぜですか？

関連トピック