Questions tagged [apiblueprint]

API Blueprint is a Markdown-based DSL for describing HTTP APIs.

Filter by
Sorted by
Tagged with
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 ...
Sadiq Khoja's user avatar
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?
Billie Tshuva's user avatar
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 [...
Josie Zhang's user avatar
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 ...
tomat364's user avatar
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-...
tvieira's user avatar
  • 1,865
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....
anil's user avatar
  • 164
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.
adg ghd's user avatar
  • 33
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[...
TimJ's user avatar
  • 426
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= ...
シェバイクン's user avatar
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 ...
frogstair's user avatar
  • 444
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 ...
Nana's user avatar
  • 1
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/...
Michael Turnwall's user avatar
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
Veerankutty VP's user avatar
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 ...
Rainer Gevers's user avatar
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,...
Emad Helmi's user avatar
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:...
Jordi's user avatar
  • 331
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 ...
Daria Bulanova's user avatar
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? # ...
SteveObrian's user avatar
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 ...
Simon Tulett's user avatar
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 ...
Haran's user avatar
  • 1,060
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 ...
larnouch's user avatar
  • 199
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 ...
alessandro candolini's user avatar
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 + ...
angelokh's user avatar
  • 9,476
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 ...
thau0x01's user avatar
  • 875
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) - ...
leifg's user avatar
  • 8,738
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 ...
zelusp's user avatar
  • 3,530
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....
Lucas Penén's user avatar
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 ...
Rong.lin's user avatar
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 ...
Nathaniel Lindsey's user avatar
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 ...
Nathaniel Lindsey's user avatar
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 ...
T.J.'s user avatar
  • 415
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[...
Elias Garcia's user avatar
  • 6,922
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 ...
JonTroncoso's user avatar
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 ...
Alo's user avatar
  • 994
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-...
Daksh's user avatar
  • 1,177
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 ...
User's user avatar
  • 2,028
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. ...
Arnold Balliu's user avatar
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 ...
John Briggs's user avatar
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. ...
Nauman Bashir's user avatar
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 ...
Dr.eel's user avatar
  • 1,855
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.
Євгеній Чупрун's user avatar
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] ...
Dr.eel's user avatar
  • 1,855
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?
S.Dan's user avatar
  • 1,824
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 ...
category's user avatar
  • 2,125
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 ...
Pramod S. Nikam's user avatar
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 ...
CDub's user avatar
  • 13.2k
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-...
King David's user avatar
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 ...
King David's user avatar
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 ...
vicdup's user avatar
  • 161
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 ...
janpio's user avatar
  • 10.7k

1
2 3 4 5