Questions tagged [apiblueprint]
API Blueprint is a Markdown-based DSL for describing HTTP APIs.
250
questions
1
vote
0
answers
186
views
How to maintain release versions of the API
Is there a way to maintain history of API releases in Apiary Blueprint? I would like to show a dropdown with release versions on my API documentation page so that user could view documentation for a ...
0
votes
0
answers
144
views
Blueprint API - How to add different ports for API calls, in the same serverurl?
I would like to add a different port for each call, but the same server URL, and I can't manage that.
for example:
{{ServerURL}}:59310/account
{{ServerURL}}:59313/inventory
how can I add the port?
1
vote
0
answers
252
views
apiary authentication description not work?
I currently have this blueprint as https://help.apiary.io/api_101/apib-authentication/#describing-basic-auth-in-api-blueprint described.
FORMAT: 1A
# Basic Auth API
## Basic Auth protected resource [...
0
votes
1
answer
219
views
Apiary change format to cURL sample
please advise. I have a problem with the cURL format in the Apiary documentation.
I insert array to +Body
+ Body
[
'command' => 'domain-list'
]
and the ...
0
votes
1
answer
286
views
How do I use another gem as a dependency and create a class that inherits from it
I'm trying to create a gem, that wraps some external API calls, and I want to use a gem called 'api-blueprint'
I already added as a dependency on my gemspec file
spec.add_runtime_dependency 'api-...
1
vote
0
answers
173
views
MSON data structures from external file
I want to use the MSON data structure defined in an external file and refer to it in my API blueprint file. Is it possible? As of now I define both in the same file.
FORMAT: 1A
HOST: https://polls....
0
votes
1
answer
439
views
How can I create a nested table of contents in apiary?
It is necessary to add sub-items to the table of contents to make it easier to navigate the existing methods, but unfortunately, I cannot find the documentation where this would be described.
0
votes
1
answer
180
views
Apiary doesn't render array[Object] clearly as an array
The following syntax:
### List Webhooks [GET /webhooks]
+ Request
+ Headers
Authorization: Bearer <API_KEY>
+ Response 200 (application/json)
+ Attributes (array[...
0
votes
1
answer
170
views
apiblueprint response download file
I'm trying to use apiblueprint.
How do I write the apib just like as below Laravel code?
public function getDownload()
{
//PDF file is stored under project/public/download/info.pdf
$file= ...
2
votes
0
answers
309
views
Document POST request with API blueprint and Apiary
I am documenting a service with API endpoints which need to be accessed with a POST request in application/x-form-urlencoded format with Apiary. The issue is, no matter how much I looked, I could not ...
0
votes
1
answer
314
views
A string in Data Structures in the Api Blueprint document
I would be very thankful if someone could tell me if I can describe a string in Data Structures, because what I'm writing (in the sample below) doesn't work as it should. "Date" and "Point" are ...
1
vote
1
answer
1k
views
Document API Request with Query Parameters with Square brackets
I'm trying to use Apiary to document my API. The URL for the request has parameters that contain objects so the parameter has a square bracket. Here is an example of what the URL path looks like
/api/...
2
votes
0
answers
423
views
Is there a way we can auto-generate create swagger spec or api blueprint for graphql [closed]
https://api.graph.cool/simple/v1/swapi
This is a sample graphql endpoint. Is there a way we can auto-generate create swagger spec or api blueprint for graphql
0
votes
1
answer
319
views
Render apiary documentation locally with the V4 interactive documentation
I would like to render API Blueprint documentation in the v4 interactive documentation format locally using apiary-cli or something similar.
I recently started using Apiary. Currently I am generating ...
2
votes
1
answer
737
views
api-blueprint does not show nested "One of" attributes correctly
This is my api blueprint file:
FORMAT: 1A
# system API
These endpoints are use to get contents from the system crawler
## Get posts [/posts/{?publish_gte,publish_lte,publish_gt,publish_lt,page,...
0
votes
2
answers
171
views
Sails 1.0 cannot access autogenerated associated entity routes
I have an association between Client and Budget as follows:
//Client.js
module.exports = {
primaryKey: 'id',
attributes: {
id: {
type: 'number',
unique: true,
autoIncrement:...
2
votes
1
answer
277
views
How to create object field in api-blueprint?
I am trying to document POST request with one object field and one predefined. How can I do it properly? This solution breaks the Schema after api-blueprint parsing.
### Create order [POST]
Create a ...
2
votes
1
answer
741
views
api blueprint mson object with different values
I have a collection response which gives back an array of user objects and want to have different values for the user attributes without to create multiple user objects. Is there a way to do this?
# ...
0
votes
0
answers
799
views
What is the correct format for query string and path parameters?
I am using API blueprint to mock a set of real world endpoints and am having trouble combining path and query string parameters.
The real world endpoint has a query string parameter appearing 1st ...
5
votes
1
answer
4k
views
How to reference enum value in API Blueprint(MSON)
I'm using API Blueprint and Agilo to render my API documentation. When using enum type, I'm observing a weird behavior. The response is not shown with the defined enum value whereas the schema is ...
0
votes
1
answer
118
views
How to exclude a test from appearing in the documentation
I'm working with Dredd the HTTP API Testing Framework to test my backend apis.
Well the idea is that each time you create a test case a documentation will be generated automatically which is a good ...
0
votes
1
answer
121
views
Dredd Apiary contract driven test - Is there any way to access private apiary documentation blueprint format from local dredd config?
I'm running contract driven development tests using dredd.
I know how to configure dredd tests to run either against a local or remote server, given a blueprint apib file. Typically, the relevant ...
2
votes
0
answers
181
views
API Blueprint Data Structures Enum Output to Schema
I have defined an Enum at Data Structures and then compile with aglio. The output schema somehow adds a null. How can I get rid of that null?
## StatusType (enum[string])
+ Verified
+ Unverified
+ ...
1
vote
0
answers
280
views
How to describe a `multipart/form-data` request in blueprint documentation standard?
i'm trying to document an API and one of these endpoints works as multipart/form-data content-type recipient to catch user uploads, and the whole other endpoints works as application/json content-type ...
1
vote
0
answers
233
views
Parameterize a Data Structure in API-Blueprint
I vaguely have the following document:
# Group Cats
## Get ALl The Cats [GET /api/v1/cats{?page%5bsize%5d,page%5bnumber%5d,sort,filter}]
+ Parameters
+ page%5bsize%5d: 10 (number, optional) - ...
1
vote
0
answers
171
views
Repeating a MSON data structure with different values
I have many places in my API where I will need to describe a list of objects. Each object has the same keys / structure but different values. How can I tweak the values of each instance of some data ...
1
vote
1
answer
4k
views
SailsJS blueprint GET model with no limit
I have a problem.
I need to use GET blueprints and I would like to receive all (without a limit) of my Models objects (think in one Model called Student). So, to do that I added in sails.config....
0
votes
2
answers
288
views
Dredd Api Blueprint for text format
There is an api blueprint dredd test problem which bothers me for a while.
I can dredd test json format successed, but for text format, it always be failed.
The fail message -> fail: body: Real ...
0
votes
1
answer
669
views
API Blueprint on-page links in Resource group?
I'm writing a product data API in Blueprint and I'd like to provide a link in the styleNumber parameter to a # Group Value References beneath the Resource.
## GET Details for products that match any ...
0
votes
1
answer
550
views
Adding Plain text headers in API Blueprint
API Blueprint appears to have an undocumented rule that prevents plain text headers below or between resource groups. I have three plain text headers above my resource group that display with no ...
1
vote
1
answer
1k
views
Apiary Blueprint attributes under headers and body are not recognized
Final Edit: This works with no semantic errors:
+ Request
+ Headers
Accept: application/json
Content-Type: application/json
X-Auth-Client: Your Client Id
...
0
votes
1
answer
484
views
Is it possible to define a fixed array length in API Blueprint?
I'm writing an API specification in API Blueprint and I want to define a location attribute to be a fixed array of length 2, like this:
I have written it as a number array like:
+ location (array[...
0
votes
1
answer
346
views
Parameters not showing up in valid apiary document in api blueprint
Like the title says. It works if I change + Parameters to + Attributes but I want to do this the right way so I can try to get dredd working and added to ci.when I'm done.
From all the docs this ...
1
vote
1
answer
95
views
Do IBM Bluemix and Azure provide equal support to API Blueprint and OpenAPI? To describe APIs
I could use some help deciding which API Description Language to use for the APIs our team has deployed on IBM Cloud and possibly Azure in the future.
We have been using API Blueprint informally, but ...
1
vote
1
answer
321
views
How do I add documentation / description to a Header parameter?
For the Headers section, I need to describe what each header parameter / field / entry is. How would I go about doing that?
Currently, my Headers section looks like this:
+ Headers
Access-...
4
votes
3
answers
3k
views
Generating an API blueprint documentation from Django/DRF code
Is there any lib/parser which can generate API blueprint documentation (apiary) from Django + Django Rest Framework code? Eg:
class UserView(...):
"""
## Users list [GET /users]
+ Request ...
2
votes
1
answer
223
views
Referencing a property inside a defined data structure in API Blueprint/MSON
I've been working with the API Blueprint format for designing an API and have had a lot of fun working with it. When I was declaring my data structures I came upon a code reuse or model reuse issue.
...
0
votes
1
answer
1k
views
Submitting image to Laravel 5.5 via post request with API Blueprint
Trying to do something pretty simple but just need a bit of specific knowledge to get it to work.
I'm trying to submit an image in a post request to a post route in Laravel 5.5.
While retrieving a ...
2
votes
1
answer
219
views
Api blueprint failing with dredd on a realtime api?
I am in the middle of upgrading dredd from 1.08 to the latest version, while at it, I am trying to validate our api documentation, written in blueprint with the realtime test api and it is failing.
...
0
votes
1
answer
309
views
How to define ApiBlueprint array values example with MSON?
Can I use MSON to specify an example values instead of + Body?
Is it possible to override predefined structure values?
I've tried like this:
+ Request (application/json)
+ Headers
...
0
votes
0
answers
806
views
in Blueprint.js when I try to use popover into an overlay. Second one close by popover closing
When I try to use popover inside Overlay, it closes when popover close. It looks like popover's closing remove something from body element.
0
votes
1
answer
1k
views
MSON to JSON-Schema "One of" issue
I'm try to describe in ApiBlueprint MSON notation an object with variable part.
Here the simple code in ApiBlueprint :
FORMAT: 1A
# Test API
## Services [/Service/{id}]
### GET Service info [GET]
...
1
vote
0
answers
175
views
How to add file attribute in request body?
I'm trying to document API through apiary.io and I want to add the following request body where there is a file in the form of key-value pair:
How can I add this file in request body in apiary?
0
votes
1
answer
82
views
Dredd failing to parse apiblueprint response body
My .apib document has the following response defined:
21 + Response 200 (application/json)
22
23 + Body
24
25 {
26 "Datetime: "2017-04-23T18:25:43.700Z",
27 ...
8
votes
1
answer
10k
views
What is distinctive purpose of API Blueprint vs Swagger? [closed]
I am trying to develop application in cloud native way. I am trying have API first design of my application.
Which API documentation tool should I use? which one is more suitable for API first ...
6
votes
0
answers
626
views
Represent File Uploads in API Blueprints
We have an API end point where an image file can be uploaded along with the name of the file (a string) as well as a description (string).
Apiary / API Blueprints won't allow me to have something ...
0
votes
2
answers
285
views
Ambari cluster + what is the right syntax in order to upload blueprint json file to ambari cluster
we have Ambari cluster Version 2.5.0.3 , while all clients machines are Linux redhat
first I generated the json file to my Linux machine as the following: ( on ambari server machine )
curl -H "X-...
2
votes
1
answer
248
views
How to reconfigure Ambari services values with blueprint.json file
we have many Ambari LAB clusters - Apache Ambari Version 2.5.0.3 , while ambari agent installed on Linux redhat machines
my target is to find a way to update the values of services , on all the ...
2
votes
2
answers
241
views
Dredd / apiary / MSON array of any size
we're struggling describing an array of any size in our API. Using API Blueprint and MSON format for Dredd testing.
Endpoint /spots should return an array of "Spots" (those are objects). We don't ...
1
vote
1
answer
2k
views
How to document optional parameters in path in API Blueprint?
Assume there is an API that has an optional parameter in in the URL path:
## Get FooBar [/foo/bar/{type}]
+ Parameters
+ type (optional, string, `widget`) ... Filter for a specific bar type
Of ...