僕が考えた最強のAPIドキュメント生成 - 銀の人のメモ帳
2023 追記 2023 年現在では、以下の文章では採用を見送っている OpenAPI を使えば OK という雰囲気です。 Web APIの設計 作者:Arnaud Lauret翔泳社Amazon TL; DR ドキュメント生成にはkevinrenskers/raml2htmlを使った ドキュメントはRAML - RESTful API modeling languageで書いた RAMLにはJSON SchemaとJSONを記載できる APIで返ってくるJSONはRailsアプリのrequest specでJSON Schemaを使ってテストした JSON Schemaはr7kamura/json_worldで生成した ドキュメントに載せる例示のJSONもJSON Schemaからgin0606/screijiを使って生成した 上記の方法だとリクエストパラメタとドキュメントの整合性を担保
RAML Tools | APIhub
You'll get the same great, easy-to-use API Portal capabilities, but now with all the breadth of the full Anypoint Platform for APIs, including: API Management Key provisioning API implementation based on RAML Continue RAML Tools Anypoint supports RAML (RESTful API Modeling Language) with the following tools designed to help improve how RESTful APIs are defined and consumed. Learn more about RAML a
The Vision Behind Swagger, API Blueprint and RAML
I am working through some deeper research into the world of API design, and specifically into the world of API definitions. This research involves talking to each of the leading providers, crafting a series of stories along the way, resulting in a white paper that provides an overview of the space and possibly where things are going. During my conversations with Tony Tam (@fehguy) of Wordnik, crea
API Design: Do You Swagger, Blueprint or RAML?
I’m spending the next couple weeks going through each of the leading API design approaches: API Blueprint, RAML and Swagger. Even though I still personally use Swagger in my own work, I’m pushing myself to learn API Blueprint and RAML to better understand the landscape, as well as the pros and cons of each approach. If you aren’t familiar with this emerging trends in API design, they are approache
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
MuleSoftがRESTful APIを設計するRAMLツールをリリース
GitHub - raml2html/raml2html: RAML to HTML documentation generator.
GitHub - mulesoft/osprey: Generate Node.JS API middleware from a RAML definition
API Design Tooling From RAML
Welcome