ledisdb/server/http/readme.md

1.3 KiB

##HTTP Interface LedisDB provides http interfaces for most commands. ####Request The proper url format is

http://host:port[/db]/cmd/arg1/arg2/.../argN[?type=type]

'db' and 'type' are optional. 'db' stands for ledis db index, ranges from 0 to 15, its default value is 0. 'type' is a custom content type, can be json, bson or msgpack, json is default.

####Response

The response format is

{ cmd: return_value }

or

{ cmd: [success, message] }

'return_value' stands for the output of 'cmd', it can be a number, a string, a list, or a hash. If the return value is just a descriptive message, the second format will be taken, and 'success', a boolean value, indicates whether it is successful.

####Example #####Curl

curl http://127.0.0.1:11181/SET/hello/world
→ {"SET":[true,"OK"]}

curl http://127.0.0.1:11181/0/GET/hello?type=json
→ {"GET":"world"}

#####Python Requires msgpack-python and requests

>>> import requests
>>> import msgpack

>>> requests.get("http://127.0.0.1:11181/0/SET/hello/world")
>>> r = requests.get("http://127.0.0.1:11181/0/GET/hello?type=msgpack")
>>> msgpack.unpackb(r.content) 
>>> {"GET":"world"}