Looks like the Great Firewall or something like it is preventing you from completely loading www.skritter.com because it is hosted on Google App Engine, which is periodically blocked. Try instead our mirror:
This might also be caused by an internet filter, such as SafeEyes. If you have such a filter installed, try adding appspot.com to the list of allowed domains.
All requests are standard HTTP requests that return JSON strings. There are some GET parameters that any endpoint will accept (whether it's a GET request or not):
POST and PUT requests sometimes require a JSON formatted entity. These entities should be sent in the HTTP body, but parameters are still GET no matter what.
There are two ways to gzip information: the GET parameter listed above, and through headers.
To gzip with headers, set
gzip in the request.
It's recommended you use the header system when possible. Response headers will be
completely correct, and it's more efficient. The GET method will not
Content-Encoding header correctly set to 'gzip'.
Because Skritter is hosted on Google App Engine and they don't allow very much control of the gzip process. But we still want a way for AJAX requests to get compressed content, and AJAX requests can't have the User-Agent or Accept-Encoding headers set. So until there's a better solution, both methods are available.
Responses are all JSON objects, and include the following parameter:
If something goes awry, responses will use one of the following HTTP codes:
The server may return other codes if something happens before the API code even gets started, in which case you probably won't get something JSON formatted, but rather some HTML. Handle all cases!
Error responses will have the following properties: