All Questions
188 questions
4
votes
1
answer
110
views
Is there an RSS feed or question that has API changes?
Is there someplace that we can find notifications of API changes? I noticed today that a new property has been added to user along with a couple new method (and maybe other changes).
Is there an ...
- 253
7
votes
4
answers
352
views
please add a key fields to stackauth results
While it is a step in the right direction, the /sites return is missing a vital component: a key field.
All of the data currently in /sites is the arbitrary data that can change.
We need a constant ...
- 12.1k
4
votes
2
answers
155
views
Please provide a mechanism for retrieving random questions
A lot of ideas I've had for Stack apps have been of the "question of the day" variety. It would be nice if there was a way to retrieve one or more random questions.
/questions/random/
The max ...
- 3,313
14
votes
1
answer
304
views
Can we have some sort of notification system?
It seems like the only way to get notified of certain events is to poll the site continuously. And as per the current policy, it seems like there should be at least a 2 minute delay between requests.
...
- 23.3k
1
vote
1
answer
95
views
Shouldn't there be a separate call for featured questions?
I find it rather peculiar that you can sort questions by featured. My arguments:
What does order mean in this case? It could mean the bounty amount (e.g. using desc would return the questions with ...
- 1,522
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 ...
- 12.1k
3
votes
0
answers
52
views
API Help Suggestion: /search - can we make tagged,nottagged description consistent with other list params
on most other params that accept a semi-colon delimited list we see
list of tags questions must have, semicolon delimited
A single primary key identifier or a vectorized, semicolon-delimited list of ...
- 12.1k
1
vote
1
answer
85
views
added_date in users/{id}/favorites method result
Is it possibile to include an "added_date" parameter on users/{id}/favorites method result?
It would be helpful when method is called with "added" sort parameter.
- 7,995
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 ...
- 12.1k
1
vote
1
answer
96
views
Abstract paged results to enable cleaner libraries
It would make great sense for paged results array property to have a common name, items perhaps.
For those writing in languages that support 'generic' constructs, this would simplify the code ...
- 12.1k
4
votes
2
answers
108
views
Possible bug in the help page?
There are some weird dot things in this help page:
api.stackoverflow.com/0.8/help/method?method=users/{id}/badges
{Dead link to missing image: http://files.quickmediasolutions.com/stackbug.png}
...
- 23.3k
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 ...
- 12.1k
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 ...
- 12.1k
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.
- 12.1k
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 ...
- 12.1k
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 ...
- 12.1k
1
vote
1
answer
40
views
help page issue: revisions by revisionguid example needed
/revisions/{id}/{revisionguid} - usage of this route is not clear to me.
can someone provide a working url and perhaps a simple use case.
- 12.1k
1
vote
1
answer
44
views
help page format issue: missing parameter
/users/{id}/tags is missing id parameter
fixing this will remove one more special case from my parser.
- 12.1k
1
vote
1
answer
57
views
help page format issue: revisionGuid
http://api.stackoverflow.com/0.8/help/method?method=revisions/{id}/{revisionguid}
revisionGuid is inconsistent.
revisionguid seems appropriate (and will remove one special case from my api parser).
- 12.1k
4
votes
2
answers
178
views
Get a user's "interesting tags"
The current implementation of the API does not provide a way for us to fetch a user's "interesting tags". The /users/{id}/tags unfortunately returns all tags a user has participated in, which I'm not ...
- 1,522
3
votes
1
answer
72
views
Minor typo on help page
On the API Routes help page, this:
/users/{id}/favorites Gets summary information for the questions that have been favorited a set of users.
should probably be:
/users/{id}/favorites Gets ...
2
votes
3
answers
317
views
Can there be a way to find a user given his email hash?
Given a user's email, it would be great if we could hash it and search for that user with it.
The reason for this is suppose:
Someone has a website
On that website, they invite SO users to enter ...
- 23.3k
1
vote
1
answer
77
views
Can we have all possible closed reasons in help page?
Can we have all possible closed_reasons in help page and if possible, closed_reason_id, too?
For example
closed_reason_id=1, closed_reason="exact duplicate",
closed_reason_id=2, closed_reason="off-...
- 5,022
1
vote
1
answer
62
views
The user and owner objects appear to be optional in the question timeline result.
This is probably just a simple documentation fix and not really a bug. The doc for the /questions/{id}/timeline method says that the user and owner objects are not optional, but they aren't always ...
- 3,315
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": {
...
- 5,022
1
vote
1
answer
76
views
Return URL of the non-API question URL
I would find it very useful, if the API response for question (and answer etc.) contained a URL to the question page itself (preferably absolute).
E.g. the response for question 305 here would ...
- 216
2
votes
1
answer
57
views
/users/{id} and /users/{id}/timeline - filter parameter?
Both /users/{id} and /users/{id}/timeline say they take a filter parameter for users' names, but it seems to do nothing. Are they not supposed to be there?
- 369
3
votes
1
answer
98
views
Methods that return comments document body and comments parameters but they do nothing
Methods that return comments document the "body" and "comments" parameters, but they have no effect on the results, which cannot include comments and always include the body.
Specific methods:
/...
- 369
3
votes
2
answers
82
views
Inconsistency in the handling of multiple IDs with a duplicate
There appears to be some inconsistency in the way multiple ids are being handled, especially when a duplicate exists.
Duplicate ID is significant
For example, when requesting a timeline of multiple ...
- 133
4
votes
1
answer
118
views
Confirmation on sort, order and min/max
I'd like confirmation, if possible, that the following chart of sort types is correct:
sort |orderable|min/max |min/max type
------------------------------------------
activity | yes | ...
- 369
4
votes
1
answer
101
views
Creation of an API 'about' method for the application key being passed
Hi there!
Because the API uses a key, I'd like to ask if a request can be created so that, on application start (and, during runtime), you can ask whether your key is valid, and get back information ...
4
votes
2
answers
95
views
Document fields that may be not be included in responses
I'd like to see documentation on what fields may not be included in responses or, alternatively, which fields are guaranteed to be included. Currently it's a little confusing because some fields may ...
- 369
0
votes
1
answer
62
views
questions/{id}/timeline documentation: timeline_type values not listed
The timeline_type for post timelines just says "string" for the "values". From a cursory look at a few questions, I've seen the following types of events:
question
answer
comment
revision
votes
The ...
- 369
2
votes
1
answer
70
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,022
3
votes
2
answers
166
views
Provide a "latest" version for apps that want to keep up
By pointing my application at
http://api.stackoverflow.com/n.n/...
or possibly http://api.stackoverflow.com/latest/...
I could keep up with all the version changes released.
Alternate forms to stay ...
- 4,784
5
votes
1
answer
142
views
Two minor typos in the API help
In http://api.stackoverflow.com/0.8/help
/users/{id}/answers Gets answer summary informatino for the user with 'id'.
and in the Returns section of http://api.stackoverflow.com/0.8/help/method?method=...
- 185
2
votes
4
answers
369
views
Can the server side of the API be open sourced?
I would like to see the open source Stack Exchange clones (OSQA/Shapado) to implement the same API, and this would help considerably.
- 155
109
votes
3
answers
23k
views
API Documentation and Help
Method List
All API methods can be found at https://api.stackexchange.com/docs.
Global Method Parameters
All methods accept the following parameters:
type=jsontext: responds with mime-type text/json.
...