GitBook: [master] 3 pages and one asset modified

SUMMARY.md

@@ -1,9 +1,11 @@
 # Table of contents
 
 * [Introduction](README.md)
+* [Registration](https://cacheful.app/register)
 
 ## API reference
 
+* [Introduction](api-reference/introduction.md)
 * [Projects](api-reference/projects.md)
 * [Locations](api-reference/locations.md)
 * [Sitemaps](api-reference/sitemaps.md)

api-reference/introduction.md

@@ -0,0 +1,47 @@
+---
+description: >-
+  Learn how to use our API and build your own custom sitemaps workflow, just the
+  way you like to.
+---
+
+# Introduction
+
+## API Authentication
+
+{% hint style="info" %}
+**All authorization is done through a single API token.** You can generate and/or revoke an api token at any time. To manage your api tokens, log in to your account and navigate to your settings panel. You'll find the API tab in the left sidebar. Remember to include your bearer token in the **Authorization header** for every API request.
+{% endhint %}
+
+```javascript
+{ "Authorization": "Bearer: your-secure-bearer-token-here" }
+```
+
+## Example with curl
+
+You can use `curl` to do API requests. Here's an example, including the required `Authorization` header.
+
+```bash
+API_TOKEN="your-api-token-here";
+curl -XGET \
+    -H "Authorization: Bearer ${API_TOKEN}" \ # Authenticate with Bearer token
+    https://sitemap.sh/api/projects > ./results.json
+```
+
+{% hint style="info" %}
+Use `json_pp` to beautify JSON output from your command line. [Here's the manpage](http://manpages.ubuntu.com/manpages/disco/man1/json_pp.1.html).
+{% endhint %}
+
+#### Beautify JSON output
+
+```bash
+╰─$ echo '[{"key":"value"},{"key2": "value2"}]' | json_pp
+[
+   {
+      "key" : "value"
+   },
+   {
+      "key2" : "value2"
+   }
+]
+```
+

api-reference/projects.md

@@ -25,12 +25,6 @@ This endpoint will provide all the projects you own.
 
 {% api-method-spec %}
 {% api-method-request %}
-{% api-method-query-parameters %}
-{% api-method-parameter name="Authorization" type="string" required=true %}
-_Include your bearer token in the authorization header for every request!_
-{% endapi-method-parameter %}
-{% endapi-method-query-parameters %}
-{% endapi-method-request %}
 
 {% api-method-response %}
 {% api-method-response-example httpCode=200 %}