Take the 2-minute tour ×
Stack Apps is a question and answer site for apps, scripts, and development with the Stack Exchange API. It's 100% free, no registration required.

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: https://api.stackexchange.com/2.2/questions/add

Documentation Link: https://api.stackexchange.com/docs/create-question

On the screenshot you can see all the information I get for the endpoint. A few things weren't clear at first sight:

  1. Is this a POST request or would GET also work?
  2. What is the Content-Type (x-www-form-urlencoded or json ?)
  3. Which fields are required which are optional
  4. Description of all the fields:
    • What is preview for. What is the format: [true,false], ["true","false"], [0,1]?
    • How to format the list of tags?
    • What is the key, where to get it
    • How do responses look like (e.g. HTTP headers)
    • How would an example request look like

I did find out all of this information eventually but I had to make assumptions and do quite a bit of trial and error.

In contrast, the Github API for example has a different structure and provides most of the data at a glance. Example: Create an Github Issue

Screenshot

screenshot

share|improve this question
2  
I know, right? I've already reported the POST/GET issue, but the rest of it's pretty bad too. –  michaelb958 Mar 4 at 1:04
    
I just spent hours trying to figure out why I get a 400 status code. The problem was that the preview seems to be required.... –  Besi Mar 6 at 22:25
add comment

You must log in to answer this question.

Browse other questions tagged .