5
votes
Please "release" and/or document API version 2.3
Note that version 2.3 has been around since at least Aug 28, 2015 (Date of that answer).
I could have sworn that one of the SE guys said they weren't going to document it, but can't find a reference ...
- 13k
4
votes
Accepted
“Try It” URL has wrong URI
The link is correct. The purpose of that control is to provide a URL to the doc page with all the parameters prefilled. This is what most users expect and is similar to how that link control works ...
- 13k
4
votes
Documentation or API method for `option_id` information, for the `/flags/options` API calls?
The original intent of these options is clearly not to enable automated flagging, but rather to allow an application to generate a UI that presents the applicable options to a user who would be ...
- 641
3
votes
Accepted
Clarify read-only vs. write operations for Teams in documentation
API access and capabilities depend on the tier of Stack Overflow for Teams that you are subscribed to.
Free - No API access
Basic - Read-only API access
Business - Read and Write API access
The ...
- 186
3
votes
Accepted
My filter is not returning any results. How to create a minimal filter?
The key mistake here is neglecting the Wrapper Object, and this is a big flaw with the filter documentation.
The wrapper is the box that everything you get from the API comes in. You always get the ...
- 13k
3
votes
Why is "body" missing from certain inbox items?
The documentation was updated sometime in the last 2 years and the API docs (version 2.2) now state that the property may be absent:
- 13k
3
votes
What happened to the links to a Stack App mentioned in the documentation about write access?
This is a documentation bug in my opinion. The "via Example App" was never included, nor should it be.
A user is fully responsible for his or her content, it doesn't, and shouldn't, matter how that ...
- 13k
3
votes
Accepted
3
votes
Documentation or API method for `option_id` information, for the `/flags/options` API calls?
The official documentation is here:
Available flags vary from object to object, user to user, and site to site. An application should not assume that particular flags are always available, or that ...
- 131
2
votes
Accepted
What does "in practice" mean here?
Strictly speaking, that line is incorrect. The method will always return a JSON object (barring certain server failures).
But the items array will be empty or missing.
On success, the default ...
- 13k
2
votes
Accepted
Few typos in the documentation pages
The fixes for this were just pushed in the latest build. Thanks for reporting it.
- 191
2
votes
Accepted
Typos on api.stackexchange.com/docs/js-lib
Fixed, thanks to ᔕᖺᘎᕊ, for bringing it to my attention, rolling out in next API build.
- 206
2
votes
Accepted
top-answerers / top-askers documentation bug: number of results returned incorrect
Ok, this'll be corrected after the next API build.
- 641
2
votes
What are the top level question & answer localized flag_option titles?
The values for the question and answer flag_option title properties, which I've determined experimentally, are:
const flagTypes = {
/* Localizations:
* English (not localized)
* ...
- 1,658
2
votes
Accepted
Documentation describing fields for api stack exchange
The payload (both request and response) are described as Types.
You can switch the documentation page from category to type:
https://api.stackexchange.com/docs?tab=type#docs
From there you find for ...
rene♦
- 2,762
2
votes
Where do I look for a new-to-the-network technical-overview introduction to what a script/app/etc. basically is, incl. differences between them?
You can find a lot in the questions tagged faq, and the API has a comprehensive documentation with the option to test your calls online.
The best guide here (that I know of) to what a script is (on ...
- 6,885
1
vote
Accepted
Unable to post a comment using the interactive API documentation
When using the API to add/edit posts or comments, you need to ensure the preview parameter is set to false, otherwise it's just a 'test' request which does nothing (but allows you to test if the ...
- 6,885
1
vote
Wrong sorting parameter in documentation for question/{ids}/answers
No, I think this is intentional. The word on the left side is the value of the sort parameter:
while the word on the right side is a field name of the answer object:
- 6,885
1
vote
"Javascript" typo on documentation pages
This was just fixed in the latest build. Thanks for the report.
- 191
1
vote
Can the API Edit a Question, changing only one field?
Yes, you must provide all three of: tags, title, and body -- even if they haven't changed.
Otherwise you will get error messages like:
"error_id": 400, "error_message": "tags", "error_name": "...
- 13k
Only top scored, non community-wiki answers of a minimum length are eligible