mirror of
https://github.com/wallabag/wallabag.git
synced 2025-01-23 23:28:08 +00:00
Transferring API Description file from Apiary.io
This commit is contained in:
parent
f39e94ace3
commit
169d60abc7
1 changed files with 80 additions and 0 deletions
80
apiary.apib
Normal file
80
apiary.apib
Normal file
|
@ -0,0 +1,80 @@
|
|||
FORMAT: 1A
|
||||
HOST: http://polls.apiblueprint.org/
|
||||
|
||||
# wallabag
|
||||
|
||||
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
|
||||
}
|
||||
]
|
||||
}
|
Loading…
Reference in a new issue