MakeAPI
Running the Server
Prerequisites
- MongoDB
- Run this with
mongod
- Run this with
- ElasticSearch
- Run this with
elasticsearch -f
- Run this with
Dependencies
Execute npm install
in the application directory:
Running in Development mode
Configuration for Node w/ Habitat
Copy and edit your .env file. -- This should never be committed to the repo. Ensure that you fill in the ALLOWED_USERS variable.
cp env.sample .env
Running the Services
Before you start your Node.js server, you'll need to run MongoDB and ElasticSearch
Running the Node Server
Assuming MongoDB and ElasticSearch are running at the specified places in your .env
file simply running node server.js
from the root should start the server.
By default the server will run at http://localhost:5000. You can change this by adding PORT= to your .env file.
New Relic
To enable New Relic, set the NEW_RELIC_ENABLED
environment variable and add a config file, or set the relevant environment variables.
For more information on configuring New Relic, see: https://github.com/newrelic/node-newrelic/#configuring-the-agent
Deploying to Heroku
If you don't have Heroku Toolbelt get it here https://toolbelt.heroku.com/.
You will need an account with heroku. If you don't have one, sign up for one at http://heroku.com.
- Ensure you are logged in first by running
heroku login
- Go to the root of the repo.
heroku create
- Add the necessary plugins using
heroku addons:add <plugin name>
. Supported MongoDB plugins are: MongoHQ and MongoLab. Supported Elastic Search plugins are: FoundElasticSearch and Bonsai. Installing a plugin should automatically set up the required environment variables. - You should be ready to push up to heroku!
git push heroku featureBranchName:master
. If all goes well, your app should deploy. You can see logs by runningheroku logs
and you can open the MakeAPI in a browser by runningheroku open
.
Testing the API
Right now there is a small node app in test/test-make-client.js
that will require in the API and make a sample create request. This is reliant upon the the entire repo being included down and not being pulled in through NPM. Eventually there will be tests not reliant on this.
API:
HTTP Method | Path | Action | Notes | Auth Required |
---|---|---|---|---|
POST | /api/make | Create Make |
If post data contains a valid Make, it creates one and returns it with the _id.
Post Data should be a JSON object specifying the id of the authenticated webmaker creating the Make{ "maker": "username", make: { ... } }
|
Yes |
PUT | /api/make/:id | Update a Make | The Make must already exist. This is an implementation of optimistic locking.
Post Data should be a JSON object specifying the id of the authenticated webmaker updating the Make and a flag indicating if the user has admin priveliges.{ "maker": "username", make: { ... } }
|
Yes |
DELETE | /api/make/:id | Deletes a Make | The effect is that of a delete operation, though the Make is actually only marked as deleted using the deletedAt timestamp.
Post Data should be a JSON object specifying the id of the authenticated webmaker deleting the Make and a flag indicating if the user has admin priveliges.{ "maker": "username" } |
Yes |
GET | /api/makes/search | Find makes by search criteria | Searches for makes using elasticsearch. The Query String of your request must be stringified and escaped JSON, and must use elastic search's Query DSL. e.g. |
No |
Consuming the API
jQuery.ajax({
type: "POST",
url: "/api/make",
data: {
"user": "webmaker@host.com",
"make": {
"url": "http://thimble.webmadecontent.org/abcd.html",
"contentType": "application/x-thimble",
"title": "Animal something-or-other",
"locale": "en_us",
"tags": [ "awesome", "#css", "thimble.webmaker.org:project" ],
"description": "This handy HTML template makes it easy to quickly create your own text and image mashup, then publish it for sharing via Facebook, Tumblr or any web page. Your 15 seconds of internet fame await!",
"author": "swex@mozilla.com",
"remixedFrom": null
}
},
success: function(data, textStatus, jqXHR){
console.log("Post response:");
console.dir(data);
console.log(textStatus);
console.dir(jqXHR);
},
error: function(jqXHR, textStatus, errorThrown){
console.log(jqXHR.responseText);
}
});
A client library has been written to aid in the consumption of this API. Documentation can be found here
Searching Test Ground
If you load http://localhost:5000/search.html, you can use the basic set of form fields to create/update/delete makes and search based on several fields.'
Generating fake data
Running AUTH=<username>:<password node test/post.js
from the root of the repository will generate one thousand fake records in your database. Be sure to include a valid username and password as an environment variable.
Deleting all fake data
Clear elastic search:
curl -XDELETE "http://localhost:9200"
Find your mongo files and clear them. For example, if your makeapi.1
, etc. are in /data/db/
, run:
rm /data/db/makeapi.*