-
Three column layouts are all the rage. It started with the [stripe api](https://stripe.com/docs/api), then [readme.io](https://sample-threes.readme.io/v1.0/docs) and others followed suit. [Apiary.i…
-
The following blueprint:
``` md
# GET /
+ Response 200 (application/json)
+ Attributes
+ s1 (optional)
```
Renders the following JSON example
``` json
"content": "{\n \"s1\": \"\"\n}"
…
-
We are using hercule for generating our finished API Blueprint. By now a lot of thought and try/error went into _how to best create DRY blueprints?_ and one thing that turned out to be very helpful we…
-
Negative numbers in value are not parsed:
For following blueprint
``` md
#
# Data Structures
## Customer (object)
- id: -1 (number) - unique number
```
You will obtain warning:
```
warning: (6…
-
It seems that there is an [Error C2383](https://msdn.microsoft.com/en-us/library/y81x4ttb.aspx) in [SerializeAST.cc lines 596](https://github.com/apiaryio/drafter/blob/master/src/SerializeAST.cc#L596)…
-
I write an API blueprint like this:
``` markdown
# API array of object
A simple API which test array of object.
# User [/user]
## Get list of all users [GET]
+ Response 200 (application/json)
…
-
When the example parameter value in the attributes contains an underscore it is parsed incorrectly and the parameter gets name in the form : and the example value doesn't exist
This code
``` apib
+ …
-
```
../drafter/ext/snowcrash/src/MSONSourcemap.h:177: warning: ‘auto_ptr’ is deprecated (declared at /usr/lib/gcc/x86_64-redhat-linux/4.4.7/../../../../include/c++/4.4.7/backward/auto_ptr.h:86)
CXX(…
-
Imagine the following scenario;
``` markdown
## Say hello [POST /say/hello]
Say hello to someone
+ Request (application/json)
+ Attributes
+ message (boolean) - Your hello message
…
-
I'd argue it would greatly improve FTUE if aliases would be added, namely:
- `int` and `integer` for `number`
- `list` for `array`
ghost updated
9 years ago