3
votes
0answers
30 views

Incomplete information in API documentation

I am struggling a little bit with the Stackexchange API since there seems to be no formal specification for the individual endpoints of the API. Example: Endpoint: ...
0
votes
1answer
19 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?
4
votes
2answers
65 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 => ...
4
votes
1answer
62 views

Enumerated types documentation in 1.1 API

I'm starting to implement requesting question and user activity in my framework, but the new 1.1 API documentation doesn't seem to indicate what the possible return values are for the fields any more. ...
3
votes
2answers
242 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 ...
0
votes
1answer
79 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
1answer
99 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
1answer
71 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 ...