Comments (4)
Does this tie in with the JSON schemas? Using JSON schemas for request and response objects is immensely useful and would be even more so if we can link to them from any part of our API.
Edit, I have just read #19 and #20 which seems to be more appropriate to the above. I am therefore not sure what your image is for this issue.
from api-blueprint.
Not directly related to JSON schemas although a JSON schema (being an asset of API blueprint) could be a part of a data dictionary.
Take this issue more like an "umbrella issue" where #19 (and maybe even #20) are a prerequisite to have separate files (data bags) where you store your payloads referenced in blueprint.
e.g. (brainstorming here):
A data bag file:
# My Payload (application/json)
+ Headers
A:1
+ Body
{ "message" : "Hello World" }
A blueprint file:
# GET /1
+ response 200
[My Payload][]
This is of course closely related, but not identical, to #8.
from api-blueprint.
Closing this issue as duplicate. This issue should be addressed by Drafter
apiaryio/snowcrash#57 including #8 Modularity and #19 Referenced Payloads and #20 External Assets.
from api-blueprint.
This will be addressed with the introduction of MSON in API Blueprint. See #117 (comment)
from api-blueprint.
Related Issues (20)
- a
- Is api-blueprint still alive? HOT 5
- Readme.md broken links/resources HOT 1
- Ghkş HOT 2
- {"identifier":"iPhone7,1","buildid":"13A452","version":"9.0.2","url":"http://appldnld.apple.com/ios9.0.2/031-37663-20150930-0E8A5094-6491-11E5-8254-B5D151D92A8C/com_apple_MobileAsset_SoftwareUpdate/8dded0db953434c8cb5259f8339267ef83d83ded.zip","filesize":1660515500,"prerequisitebuildid":"","prerequisiteversion":"","releasetype":"","uploaddate":"2015-09-26T21:06:55Z","releasedate":"2015-10-04T19:09:45Z","marketingversion":null,"signed":false}
- What's the syntax of binary data, or does it support uploading file in form-data? HOT 1
- Wrong URL in readme.md file for navigating to the documentation URL HOT 1
- Apiary not formatting json response examples
- Can I have some description at the end of a section?
- Apiaryio/api-blueprint
- create issue
- ssh
- run configration
- thañks
- vercel
- versal
- link
- sublime
- pull shark
- pkb
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from api-blueprint.