All Questions
176 questions
7
votes
1
answer
127
views
What happened to the JSON documentation for the API?
Back in version 1.1 of the API, we used to be able to do:
http://api.stackoverflow.com/1.1/questions?help
...which would return information about the method in JSON format. However, attempting to ...
- 13k
3
votes
4
answers
283
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 ...
CommunityBot
- 1
2
votes
3
answers
76
views
What is the "inname" parameter to the /tags 2.0 API?
I'm just playing with the new 2.0 API and in /tags there is a field inname that I can't find any description or documentation for.
What does it do? Is it like the old filter parameter on the old API?
...
0
votes
1
answer
66
views
Are the "body", "comments" and "answers" parameters supported in the API version 2.x?
Earlier with version 1.x, the parameters: body, comments and answers etc. were available. But these don't seem to be supported with API version 2.x.
Are these parameters not supported in new API? Are ...
- 4,676
1
vote
1
answer
80
views
`type=jsontext` JSON results for help pages
It would greatly simplify machine reading if we could apply type=jsontext to API help pages, including the index.
Update: Here's an unofficial JSON schema for v1.x.
CommunityBot
- 1
2
votes
1
answer
89
views
Include range [1, 100] on pagesize
I see that "range" is being used to indicate valid range on most numeric parameters, e.g.
32-bit integer, range [0, 2,147,483,647]
32-bit integer, range [1, 2,147,483,647]
The smaller valid range ...
2
votes
1
answer
117
views
Indicate in documentation whether "numbers" can be non-integral
"number" is an very ambiguous term. Integral or non-integral?
For developers in more dynamically-typed languages like JavaScript, this is not an issue; but when using more statically-typed languages ...
- 13k
0
votes
1
answer
98
views
/questions/tagged/{tags} - tags param clarification
This API method has been removed as of Jul 16 '10. The original question is preserved below for posterity.
It is not clear what a "list" of {tags} looks like.
Does this parameter follow the ...
- 13k
1
vote
1
answer
83
views
Position required parameters at the top of help pages
The required id parameter for ...a lot of API routes... is now placed at the bottom of the page.
It makes more sense to place required parameters at the top of the page with a slight separation, like ...
- 13k
5
votes
1
answer
78
views
API documentation pages match some site names incorrectly
The bug is not in the API itself, but in the pages documenting its methods. To reproduce, follow the link http://api.stackexchange.com/docs/info#filter=default&site=math and observe that the page ...
- 18.7k
2
votes
0
answers
64
views
Version used by StackExchange API if version is not specified in api calls
I have used some StackExchange API calls in my chrome extension - StackEye. With the release of API 2.0, I want to update the api calls so I wanted to know
New things available in 2.0+ which were ...
CommunityBot
- 1
1
vote
0
answers
64
views
Get Token button in "Try it" doesn't give me a key in IE11
When I visit for example the timeline docs to try that api I need to get a token first by clicking 'Get Token'.
In IE11 (win 7/x64) this is broken. A window does pop-up but there is never a key ...
rene♦
- 2,762
1
vote
1
answer
78
views
Please supply working example URLs for each route
It would take a lot of the guess work out of understanding the API if each route's page provided a small handful of working URLs.
This would also serve to provide authoritative examples of the ...
- 4,676
1
vote
1
answer
89
views
/users/{id}/badges id parameter clarification
On /users/{id}/badges, the description of the id parameter
a semicolon delimited list of user ids
diverges from the inferred standard for multi-valued parameters:
A single primary key identifier or ...
CommunityBot
- 1
4
votes
1
answer
82
views
"Try it" facility suffers a double-encoding bug
As you can clearly see from the above, the ampersand in the site name in the "Try It" section of the API method documentation has been double-encoded. This affects any site with an ampersand in the ...
- 18.7k
1
vote
1
answer
86
views
What is the private_info scope for?
In the docs it says you can pass private_info for scope when authenticating a user.
What does this allow you to access, that you couldn't otherwise?
CommunityBot
- 1
3
votes
0
answers
52
views
Incorrect link parameter on the "Complex Queries" documentation page
The "Complex Queries" documentation page has this link:
Of these three posts on Server Fault, the one with the most recent activity
where "the one with the most recent activity" links to
https://...
CommunityBot
- 1
4
votes
0
answers
41
views
Link to applied_count leads to a 404
To Reproduce
Run an API query on tag-synonyms, you will get a result that includes something like this:
Issue(s)
Click on the applied_count link and you get redirected to this page which is a 404.
It ...
CommunityBot
- 1
18
votes
1
answer
278
views
Accessing Authenticated User's Close/Delete History
I'm working on the PHP chatroom's cv-pls backlog UI. Many users and myself would like the ability to track which questions we have already handled though close/delete votes. To be able to do that I ...
- 13k
0
votes
1
answer
52
views
Support for OR constraint when querying questions based on tags [duplicate]
Right now, there is no way (as far as I know) to query for questions based on multiple tags using an OR constraint.
You can query for questions tagged with multiple of these tags, but not with one or ...
- 18.7k
2
votes
1
answer
61
views
Mistake in API 2.0 Documentation - Wrong item type for Careers Message
On https://api.stackexchange.com/docs/types/inbox-item the Careers Message example shows the wrong item type.
CommunityBot
- 1
2
votes
1
answer
89
views
Top questions by tag and period
I want to get via API the most voted questions from the latest week (for example) from a specified tag (php, for example).
How can I do this?
- 343
4
votes
1
answer
288
views
How do I parse the dates from the API?
I see that JSON returned by the API contains dates in the following format:
"creation_date":1364546475
^^^^^^^^^^
What's the meaning of it? How can I parse it to get the date in the ...
CommunityBot
- 1
3
votes
1
answer
68
views
In the API, User object, what are all these reputation properties?
I am going through the JSON that is resulting from calling the Stack Exchange User API.
I see a bunch of reputation fields.
private Number reputation;
private Number reputation_change_day;
private ...
CommunityBot
- 1
2
votes
2
answers
927
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": {
...
CommunityBot
- 1
1
vote
1
answer
64
views
CDN redirect for the API's JavaScript SDK is incorrect
The API's JavaScript SDK is listed as https://api.stackexchange.com/js/2.0/all.js.
However, GET request produces the following response:
Status Code: 301 Moved Permanently
Location: https://api-...
- 18.7k
2
votes
1
answer
102
views
Maximum length of "about me" in the Stack Exchange API?
What is the Maximum length of "about me" in the Stack Exchange API?
The one from the /me path.
And in general, where are the length limits published? If anywhere?
CommunityBot
- 1
6
votes
0
answers
58
views
API docs for "stack overflow" still feature v1.0 docs
I guess I'd call this a doc bug.
Currently the page http://api.stackoverflow.com redirects to http://api.stackoverflow.com/1.0/usage, which says at the top "Don't use 1.0, use 2.1". This URL ...
- 103
0
votes
2
answers
113
views
Ajax get questions by tags ERROR
i'm trying getting questions by tags.
this is my simple code and i'm running this from my http://localhost:
<script type="text/javascript">
$(function(){
$.ajax({
url:'http://api....
- 295
2
votes
0
answers
65
views
Clarification on related tags for a tag returned by API
I was assuming that the related tags API call, returns all the tags that co-occur with the input tag. But a closer look at the API documentation indicate the following:
Returns the tags that are ...
- 121
2
votes
1
answer
24
views
type related_site not listed in 'by type' tab list
The type "related_site" is not listed in the 'by type' tab in documentation.
- 882
3
votes
1
answer
228
views
API documentation console unsuccessfully tries to load MiniProfiler results
All of the documentation pages (example) with the test console currently attempt to load MiniProfiler result data, which fails with a 404:
POST https://api.stackexchange.com/mini-profiler-resources/...
- 18.7k
4
votes
1
answer
52
views
Typo in the docs for /me
The doc says:
Returns the user associated with the passed auth_token.
This method returns a user.
It should say "access_token" instead of "auth_token".
- 18.7k
2
votes
1
answer
41
views
Confusing documentation re vectorized requests limits
The documentation for vectorized requests says this:
Most methods that take ids in the Stack Exchange API will take up to 100 of them in a single go. This allows applications to batch work and ...
- 18.7k
5
votes
1
answer
165
views
Do the terms "key" and "access_token" refer to the same thing?
I'm trying to get my head around all the limits and throttles but some terminology is confusing me:
If an application does not have an access_token, then the application shares an IP based quota ...
- 18.7k
2
votes
1
answer
66
views
No token field in the docs test page for /me/reputation-history
There is no form field for an access token at:
https://api.stackexchange.com/docs/me-reputation-history
https://api.stackexchange.com/docs/me-full-reputation-history
After attempting to Run the API ...
- 18.7k
5
votes
1
answer
37
views
Typo in API filter documentation
When using unsafe filters, the API returns the highest fidelity data is can reasonably access for the given request.
should be
When using unsafe filters, the API returns the highest fidelity data ...
- 18.7k
1
vote
1
answer
38
views
Minor typo in /tags/{tag}/top-askers/{period}
The discussion for the above method says "Returns the top 30 answerers active in a single tag, of either all-time or the last 30 days." It should be corrected as askers.
CommunityBot
- 1
2
votes
1
answer
68
views
Where can I request an API key in the docs?
Can you mention the possibility of requesting an API key in the docs? It was displayed for the 1.0 API.
CommunityBot
- 1
2
votes
1
answer
27
views
Dead link in documentation
On the docs for question timelines the link for "Question" points to /docs/type/question when it should point to /docs/types/question
- 18.7k
4
votes
1
answer
52
views
Stylistic error on the JavaScript SDK documentation page
There is a small stylistic error on the JavaScript SDK documentation page.
Your application must have the client side OAuth flow enabled, and must not have disabled the desktop application redirect ...
- 18.7k
2
votes
1
answer
47
views
There is a small discrepancy in the docs for users-id-associated
The main doc page, https://api.stackexchange.com/docs, shows /users/{id}/associated while the method page, https://api.stackexchange.com/docs/associated-users, uses /users/{ids}/associated.
It's ...
- 18.7k
3
votes
1
answer
59
views
Events: field request
The "Event" object doesn't have an easy way for getting at the object relating to the event. There's a link field, but I don't fancy having to parse the information out of that (although I could).
...
- 18.7k
1
vote
1
answer
47
views
There is a typo in the authentication documentation
There is a typo on this documentation page.
It says "The explcit OAuth 2.0 flow" but it should say "The explicit OAuth 2.0 flow".
- 18.7k
2
votes
1
answer
39
views
integer and decimal are used to describe fields in return types but not in method parameters
Integer and Decimal designations are useful in creating an accurate model of API methods and types.
These specific 'number' subtypes are used when describing types but the method parameter lists all ...
- 18.7k
1
vote
1
answer
36
views
Documentation of /users/{id}/top-answer-tags conflicts with implementation.
According to the documentation:
/users/{id}/top-answer-tags or /me/top-answer-tags – Get the top 30 tags (by score) a single user has posted answers in.
However in practice, when retrieving data ...
CommunityBot
- 1
0
votes
1
answer
82
views
API console always queries Stack Overflow
On any Stack Exchange site (well, I tried Super User (trilogy), Unix (SE-2.0 launched) and SFF (SE-2.0 beta)), the console (“Show Console” button) in the 1.1 API queries http://api.stackoverflow.com/1....
CommunityBot
- 1
4
votes
2
answers
95
views
Documentation sorted by return type
Right now the documentation is pretty terribly organized. For example, consider the things under the "Users" heading:
/users => returns Users
/users/{ids} => returns Users
/users/{ids}/answers => ...
- 18.7k
3
votes
1
answer
57
views
Documentation has broken link (JSONP)
On Wikipedia, JSONP now has its own article, instead of being part of the JSON article.
The documentation links JSONP to Wikpedia:JSON#JSONP. It should link to Wikipedia:JSONP.
- 23.3k
2
votes
1
answer
53
views
Minor spello/typo on the "Complex Queries" documentation page
The documentation page
Complex Queries
has a minor typo or spello:
The ?filter=total build-in filter is provided for just this purpose.
Should instead be:
The ?filter=total built-in filter ...
- 18.7k