From 6ed983e5a301af4bbb95abe6df410c86ef7e2f07 Mon Sep 17 00:00:00 2001 From: Julien Tanay Date: Sun, 22 Nov 2015 04:06:40 +0100 Subject: [PATCH] Transferring blueprint from apiary.io --- apiary.apib | 80 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 apiary.apib diff --git a/apiary.apib b/apiary.apib new file mode 100644 index 0000000..05c9ce3 --- /dev/null +++ b/apiary.apib @@ -0,0 +1,80 @@ +FORMAT: 1A +HOST: http://polls.apiblueprint.org/ + +# wf + +Polls is a simple API allowing consumers to view polls and vote in them. + +## Questions Collection [/questions] + +### List All Questions [GET] + ++ Response 200 (application/json) + + [ + { + "question": "Favourite programming language?", + "published_at": "2015-08-05T08:40:51.620Z", + "choices": [ + { + "choice": "Swift", + "votes": 2048 + }, { + "choice": "Python", + "votes": 1024 + }, { + "choice": "Objective-C", + "votes": 512 + }, { + "choice": "Ruby", + "votes": 256 + } + ] + } + ] + +### Create a New Question [POST] + +You may create your own question using this action. It takes a JSON +object containing a question and a collection of answers in the +form of choices. + ++ Request (application/json) + + { + "question": "Favourite programming language?", + "choices": [ + "Swift", + "Python", + "Objective-C", + "Ruby" + ] + } + ++ Response 201 (application/json) + + + Headers + + Location: /questions/2 + + + Body + + { + "question": "Favourite programming language?", + "published_at": "2015-08-05T08:40:51.620Z", + "choices": [ + { + "choice": "Swift", + "votes": 0 + }, { + "choice": "Python", + "votes": 0 + }, { + "choice": "Objective-C", + "votes": 0 + }, { + "choice": "Ruby", + "votes": 0 + } + ] + }