makeapi v0.2.0

MakeAPI

Running the Server

Prerequisites

• MongoDB
  • Run this with mongod
• ElasticSearch
  • Run this with elasticsearch -f

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.

1. Ensure you are logged in first by running heroku login
2. Go to the root of the repo.
3. heroku create
4. 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.
5. 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 running heroku logs and you can open the MakeAPI in a browser by running heroku 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:

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.*