All Questions
202 questions
5
votes
2
answers
161
views
API Help's CSS is missing
The API Help page's CSS file, located at http://sstatic.net/so/all.css, is current returning 404 for me:
<div id="header"><h1>Server Error</h1></div>
<div id="content">
...
10
votes
0
answers
626
views
Separate Request Quotas for Authorized [app]s
Imagine, if you will, you have a popular [app] hosted on a cloud computing service which is also used by a number of other [app]s. If this service forces clients to share IPs (and they all do, in ...
1
vote
1
answer
85
views
user 'about_me' field suggested_buffer_size is too small
the suggested_buffer_size of user.about_me is currently 3000.
it is apparent that this is the server-side field length.
the problem is that the text is stored server-side in markdown but when served ...
3
votes
1
answer
208
views
OBSOLETE - /search method, returning the body of the questions
Probably this is a documentation fault.
For the search method, the parameter list doesn't say anything about an optional body, but looking at the Returns description shows:
"body": {
"...
2
votes
1
answer
109
views
Error Code when API Key Limit exceeds
What will the error code be generated when API Key Limit exceeds? I need that because I have to handle this error in my application.
6
votes
2
answers
1k
views
How to protect API Keys?
I want to develop an Open Source Project with Stack Exchange API. So I have to publish the API key there. But a single IP address can only make a certain number of API requests ...
3
votes
2
answers
335
views
What am I allowed/not permitted to do with the API?
I have a site that will offer technical help and assistance for a certain niche of computer users. I can either host my own forums, or tie in with stack... but I want to be able to make money off it ...
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 ...
12
votes
1
answer
362
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 ...
1
vote
1
answer
124
views
Confusion over my API key
This is directed at the team, since nobody else will be able to help.
The key I took out for StackMobile is behaving strangely. I make a few requests, and then the limit resets to 0. (By limit, I'm ...
2
votes
1
answer
398
views
What to do with API keys if our project is open-source?
Is it OK to share the key in our source? Someone could just pick it up and use it for other purposes.
4
votes
1
answer
146
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 ...
2
votes
2
answers
261
views
Do I need API key to use StackAuth API?
StackAuth sites doco doesn't mention that it requires an API key and there are no X-RateLimit-Max and X-RateLimit-Current response headers on the request.
At this stage I am passing my API key just ...
9
votes
1
answer
1k
views
How to see which users upvoted a question?
I assume this information is tracked, since StackOverflow shows me the questions I have upvoted (when going to their question page, I can undo the upvote). I couldn't find any api call that gives this ...
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 ...
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 ...
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 ...
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 ...
7
votes
1
answer
1k
views
Is it safe to embed my API key into my javascript-only application?
I have an application I'm developing that's pure javascript and consumes the Stack API. My API key is embedded in the source which anyone could read. Is this safe?
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}
...
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 ...
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 ...
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.
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 ...
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 ...
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.
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.
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).
3
votes
2
answers
113
views
What will be rate-limit of two different applications with two valid API keys from same IP?
What will be the effective rate limit of two different applications with two valid API keys from the same IP address?
Will it be whatever only one of the keys can use? So maximum 10k?
Will rate-limit ...
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 ...
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-...
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 ...
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": {
...
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?
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:
/...
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 ...
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 | ...
28
votes
0
answers
258
views
Deleting an application key? [duplicate]
There should be delete buttons on stackapps.com/apps https://stackapps.com/apps/oauth/ so we can delete API-keys.
Or at least de-activate them? I mean, cancelled projects, etc...
A deletion button ...
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 ...
2
votes
1
answer
171
views
Don't allow requests with No Key to use existing session with valid API Key
Once I did a request with a valid API key
http://api.stackoverflow.com/0.8/stats?key=MYKEY
Every requests (from that IP) later on without key will use existing session with API key, limit counter ...
8
votes
1
answer
468
views
API Key limit 10k is Per IP Address or Globally?
Getting started FAQ says No Key limit is IP Address based, but it does not say for with API Key.
When I test my API Key from different IP Addresses, I noticed that 10k limit is globally, limit is ...
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 ...
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 ...
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
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=...
1
vote
1
answer
105
views
Can the no-key request limit be increased to 1000 for a certain amount of time?
Can the no-API-key request limit be increased to 1000 for a certain amount of time - maybe 1-2 weeks?
48
votes
0
answers
7k
views
How API Keys Work (FAQ)
What are the API request limits?
A single IP address can only make a certain number of API requests per day, depending on the presence of a valid API key.
Default API daily limits:
Key: 10,000
No Key:...
6
votes
4
answers
282
views
API key limit increase support
One of the things that came up in the discussion on this question was the fact that the 10K limits might not be enough for websites that want to use the SE API.
It might be a good idea to add a ...
4
votes
1
answer
143
views
Can I register for an API key for an "alpha" site?
I appreciate that you'll want to limit users of the no-key API, however I fear that on a daily basis I might exceed the 300 limit in testing alone.
I certainly don't want to hammer the API, but my ...
4
votes
2
answers
306
views
Can I apply the API Key first and do the application later?
I don't have an application to submit at the moment, but can I apply the key first?