2016-04-30 05 Даниил Валов. apiary - где-то между фронтендом и...
TRANSCRIPT
blueprint##Questions[/news]
###CreateaNewQuestion[POST]
Youmaycreateyourownquestionusingthisaction.IttakesaJSONobjectcontainingaquestionandacollectionofanswersintheformofchoices.
+Request(application/json)
{"question":"Yourfavouritelanguage?","choices":["Swift","Python”]}
+ Response201(application/json)
+Body{"question":"Yourfavouritelanguage?","url":"/questions/2","choices":[{"choice":"Swift","url":"/questions/2/choices/1","votes":0},{"choice":"Python","url":"/questions/2/choices/2","votes":0}]}
MarkdownSyntaxforObjectNotation
JSON:
{"id":"1","name":"Agreendoor","price":"12.50","tags":["home","green"]}
MSON:
-id:1-name:Agreendoor-price:12.50-tags:home,green
##News[/news]
###ListNews[GET/news?offset={offset}&number={number}]
+Parameters+offset:0(number)-Offset(default:0)+number:20(number)-Numberofnews(default:20)
+Response200(application/json)
+Attributes(array[Newspreviewitem])
###Newsdetail[GET/news/{id}]
+Parameters+id:`56bb2ee7a4016a528511fc35`(string)-Id
+Response200(application/json)
+Attributes(Newsdetailitem)
dredd
• Blueprint• MSON• Hooks• Reporters:apiary,markdown,htmletc.• CI:Jenkins,TravisCI,CircleCI,TeamCityetc.• Languages:PHP,Ruby,Python,NodeJS,Goetc.
Apiary–этодорого?
Выможетеполучитьэтовсёвсегоза
вмесяцдлякоманды
или
БЕСПЛАТНОдляличногоиспользования
$99
Чтовыполучите?
• сервисдокументированияAPI;• редакторAPIсподдержкойBlueprintиSwagger;
• собственныйmock-сервер;• собственнаясистематестированияdredd;• 131открытыйрепозиторийвGitHub сразнымиполезнымибиблиотекамидляApiary.