mongo-restful
A very simple RESTful MongoDB proxy.
Allows you to query a MongoDB database over HTTP:
MongoDB <--- HTTP --> Browser
Limitations
Currencyly the API is read-only. Feel free to do a pull request :)
Installation
Install as a global binary:
npm install -g mongo-restful
Include into your own server:
npm install --save mongo-restful
CLI
Just run the following command:
mongo-restful [options] [arguments]
Specify the MongoDB URI as the first argument to the mongo-restful command.
Options:
--port
- specify which port the HTTP server should run on (defaults to 8080)
Example:
mongo-restful --port 3000 localhost/my-database
Integration
You can also integrate mongo-restful into your exsiting node project:
var mongoUri = 'localhost/my-database';var proxy = mongoUri;proxy;
REST API
Query a collection:
GET /my-collection?q=...
Use query parameters to filter your query. All query parameters are optional, but if none are given the entire collection is retuned!
Query parameters:
- q: The MongoDB query. Use MongoDB Extended JSON syntax, e.g.
{"createdAt":{"$date":"2014-01-01T00:00:00Z"}}
- filter: Optional projection, e.g.
{"foo":1}
- sort: Optional sorting object, e.g.
{"bar":-1}
- limit: Return only n results
- skip: Skip n results
Request a specific document:
GET /my-collection/id
Note: It's expected that id
is a MongoDB ObjectId.
License
MIT