Typekit API example conventions
Most examples in this documentation use curl — a command line HTTP client — to demonstrate API usage. Curl is already installed by default on Mac OS X and most Linux distributions, and is available for download on Windows. Curl has many many options, to read this document you only need to know about a handful of them:
-stells curl to not output a progress bar, we use this to make the documentation easier to read
-F name=valuetells curl to pass a form parameter called "name" with the value "value"
-H name:valuetells curl to pass a HTTP header called "name" with the value "value"
Most API methods need authentication which makes the examples verbose and hard to copy. To help with this we use the convention of putting the auth header in a tk_auth shell variable. If you're using Bash, you can run the following (substituting your token) to set up your shell to run the examples:
$ export tk_auth=X-Typekit-Token:4d6141e7c82cb30affebcc392abc2ce3ab0ea4c1
Then you can make authenticated requests:
$ curl -s -H $tk_auth http://typekit.com/api/v1/json/kits/
We also use jsonpretty to make the JSON output easier to read.