Questions tagged [apiblueprint]
API Blueprint is a Markdown-based DSL for describing HTTP APIs.
251
questions
0
votes
0
answers
113
views
API Blueprint # Data Structures vs. ## Data Structures
It is a bit confusing to me that there are two kinds of Data Structures that can be defined.
What is the difference between them and when to use which one ?
https://apiblueprint.org/documentation/...
0
votes
0
answers
107
views
Different API Blueprint APIs by different values of a same parameter
There are multiple API endpoints like below. They start with the same path and have the same set of parameters. The only difference is, they have different values for the type parameter.
GET /reports?...
0
votes
0
answers
49
views
Using blueprints for filter dates
I'm trying to find items in my mongodb, running blueprints in Sails, filtering data using CreatedAt field, For example:
https://myapi.com/data?where={"createdAt":"'2021-08-15'"}
I'...
1
vote
0
answers
134
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
132
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
152
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
113
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
298
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
99
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
105
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= ...
1
vote
0
answers
197
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
214
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 ...
0
votes
1
answer
669
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
248
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
258
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
545
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
158
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
222
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
582
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
485
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 ...
3
votes
1
answer
3k
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
92
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
104
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
143
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
192
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
217
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
133
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
236
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
530
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
405
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
899
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
390
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
271
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
92
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
265
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
185
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
200
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
242
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
505
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
127
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
70
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 ...
10
votes
1
answer
9k
views
What is distinctive purpose of API Blueprint vs Swagger?
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 ...
5
votes
0
answers
496
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
255
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-...
1
vote
1
answer
219
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
215
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 ...