mirror of
https://github.com/wallabag/wallabag.git
synced 2025-02-03 04:22:27 +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