Questions tagged [documentation]
Question pertaining to the documentation provided with the API.
28 questions
32
votes
1
answer
11k
views
Looking for a beginner's tutorial to using the API
I see the Stack Exchange API but I'm unable to understand it. I don't think there is any fundamental tutorial showing how to use Stack Overflow fully in the API documentation.
I want some fundamental ...
- 423
10
votes
0
answers
315
views
Tell us that POST is required to write
While troubleshooting /posts/{id}/comments/add in order to answer Why am I getting a 404 when trying to post a comment?, it was noticed that the API path in question only responded to POST requests. ...
6
votes
1
answer
1k
views
Please "release" and/or document API version 2.3
I was playing around a bit with Fiddler to capture traffic from the Stack Exchange iOS app. To my surprise, it uses version 2.3 of the Stack Exchange API:
I noticed here that it has some extra ...
- 6,965
12
votes
1
answer
415
views
How the /sites method is meant to be used
The /sites method is used to enumerate all sites in the network. If your [app] is meant to run against more than a single site (and many are) this method is how you should be discovering new sites in ...
4
votes
1
answer
151
views
AND searching for tags?
I am using the search api to search for questions that are tagged with "tags" and not with "tags". However I have noticed that searching for tags is an OR search.
The questions search for tags is an ...
- 465
4
votes
0
answers
145
views
Parameter `tagged` in `search/advanced` seems to use `AND` instead of `OR`
It seems that search/advanced has the same problem as in "The tagged parameter does not work with multiple tags" question.
When I select c#; .net I only get results tagged both c# and .net:
http://...
- 175
3
votes
4
answers
350
views
Is it really worth to (implicitly) discourage documentation of API/library usage nowadays already?
Update:
Kevin provided an answer, which, while adding something of value to the three related questions together (by naming the originating concern eventually), actually does not apply to the ...
- 1,380
20
votes
3
answers
209
views
Documentation or API method for `option_id` information, for the `/flags/options` API calls?
The Stack Exchange API has a couple of calls that return a list of flag_option objects.
These objects contain a couple of properties that can be used to identify the flag you need.
For example, when ...
- 331
5
votes
1
answer
773
views
Is it possible to authenticate a user through Stack Overflow API?
Is it possible to use the Stack Overflow API to authenticate a given user identity such as with Facebook, Twitter, or OpenID?
If it's possible: Can you tell me the method (s) that make this happen?
- 51
5
votes
1
answer
220
views
Few typos in the documentation pages
https://api.stackexchange.com/docs/vectors
When passing a vector, sepeate each id with a semicolon. For example, /users/1;2;3;4;5?site=somesite would fetch users with ids 1 through 5 on somesite.
...
- 566
3
votes
1
answer
129
views
Why is "body" missing from certain inbox items?
I have run into some confusion over the presence of the body attribute in an inbox-item returned by the /inbox method.
When item_type is set to "careers_invitations", the body attribute appears to be ...
- 23.2k
2
votes
1
answer
99
views
questions/{id} help page sort parameter description is inconsistence with others
The description of the Sort parameter in questions/{id} help page is inconsistent with those of other pages.
On the questions/{id} help page:
sort (optional):
How a collection
should be ...
- 5,042
2
votes
2
answers
1k
views
Can we have maximum length of string in API help pages?
For the type "string", I think there is some upper limit of character count.
For example,
post title : 200 characters
post body : 30000 characters
In the help page, currently like this
"body": {
...
- 5,042
2
votes
1
answer
197
views
How do I find all questions/answers per a tag?
Would also be good if I could also find the top questions/answers in a particular tag - i.e. questions tagged with Ruby or PHP.
Per the docs the only thing I can see that will return questions in a ...
- 143