GitBook: [master] 3 pages modified
This commit is contained in:
committed by
gitbook-bot
parent
7491c94704
commit
3d703160d1
67
README.md
67
README.md
@@ -1,9 +1,62 @@
|
|||||||
# Conduit
|
# Initial page
|
||||||
## Getting Started
|
|
||||||
|
{% api-method method="get" host="https://api.cakes.com" path="/v1/cakes/:id" %}
|
||||||
|
{% api-method-summary %}
|
||||||
|
Get Cakes
|
||||||
|
{% endapi-method-summary %}
|
||||||
|
|
||||||
|
{% api-method-description %}
|
||||||
|
This endpoint allows you to get free cakes.
|
||||||
|
{% endapi-method-description %}
|
||||||
|
|
||||||
|
{% api-method-spec %}
|
||||||
|
{% api-method-request %}
|
||||||
|
{% api-method-path-parameters %}
|
||||||
|
{% api-method-parameter name="id" type="string" %}
|
||||||
|
ID of the cake to get, for free of course.
|
||||||
|
{% endapi-method-parameter %}
|
||||||
|
{% endapi-method-path-parameters %}
|
||||||
|
|
||||||
|
{% api-method-headers %}
|
||||||
|
{% api-method-parameter name="Authentication" type="string" required=true %}
|
||||||
|
Authentication token to track down who is emptying our stocks.
|
||||||
|
{% endapi-method-parameter %}
|
||||||
|
{% endapi-method-headers %}
|
||||||
|
|
||||||
|
{% api-method-query-parameters %}
|
||||||
|
{% api-method-parameter name="recipe" type="string" %}
|
||||||
|
The API will do its best to find a cake matching the provided recipe.
|
||||||
|
{% endapi-method-parameter %}
|
||||||
|
|
||||||
|
{% api-method-parameter name="gluten" type="boolean" %}
|
||||||
|
Whether the cake should be gluten-free or not.
|
||||||
|
{% endapi-method-parameter %}
|
||||||
|
{% endapi-method-query-parameters %}
|
||||||
|
{% endapi-method-request %}
|
||||||
|
|
||||||
|
{% api-method-response %}
|
||||||
|
{% api-method-response-example httpCode=200 %}
|
||||||
|
{% api-method-response-example-description %}
|
||||||
|
Cake successfully retrieved.
|
||||||
|
{% endapi-method-response-example-description %}
|
||||||
|
|
||||||
|
```
|
||||||
|
{ "name": "Cake's name", "recipe": "Cake's recipe name", "cake": "Binary cake"}
|
||||||
|
```
|
||||||
|
{% endapi-method-response-example %}
|
||||||
|
|
||||||
|
{% api-method-response-example httpCode=404 %}
|
||||||
|
{% api-method-response-example-description %}
|
||||||
|
Could not find a cake matching this query.
|
||||||
|
{% endapi-method-response-example-description %}
|
||||||
|
|
||||||
|
```
|
||||||
|
{ "message": "Ain't no cake like that."}
|
||||||
|
```
|
||||||
|
{% endapi-method-response-example %}
|
||||||
|
{% endapi-method-response %}
|
||||||
|
{% endapi-method-spec %}
|
||||||
|
{% endapi-method %}
|
||||||
|
|
||||||
|
|
||||||
Simply run
|
|
||||||
```
|
|
||||||
./tools/app/start.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
And go to [http://localhost:8080]()
|
|
||||||
|
|||||||
5
SUMMARY.md
Normal file
5
SUMMARY.md
Normal file
@@ -0,0 +1,5 @@
|
|||||||
|
# Table of contents
|
||||||
|
|
||||||
|
* [Initial page](README.md)
|
||||||
|
* [Test](test.md)
|
||||||
|
|
||||||
25
test.md
Normal file
25
test.md
Normal file
@@ -0,0 +1,25 @@
|
|||||||
|
# Test
|
||||||
|
|
||||||
|
## Getting Super Powers
|
||||||
|
|
||||||
|
Becoming a super hero is a fairly straight forward process:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ give me super-powers
|
||||||
|
```
|
||||||
|
|
||||||
|
{% hint style="info" %}
|
||||||
|
Super-powers are granted randomly so please submit an issue if you're not happy with yours.
|
||||||
|
{% endhint %}
|
||||||
|
|
||||||
|
Once you're strong enough, save the world:
|
||||||
|
|
||||||
|
{% code title="hello.sh" %}
|
||||||
|
```bash
|
||||||
|
# Ain't no code for that yet, sorry
|
||||||
|
echo 'You got to trust me on this, I saved the world'
|
||||||
|
```
|
||||||
|
{% endcode %}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Reference in New Issue
Block a user