studiointeract / meteor-http-publish

Adds HTTP server publish - HTTP.publish

HTTP.publish

This package add the ability to add HTTP server publish to your project. It's a server-side package only.

##Usage HTTP.publish creates a http crud restpoint for a collection - only one cursor is allowed pr. publish

###Security CRUD+L - Create Read Update Delete + List are common rest point operations.

All CUD methods are the exact same as the ddp methods handlers - This means that Meteor.allow and Meteor.deny are setting the access rules for both ddp and http collection methods.

All R+L methods are limited to the publish function.

###Fully mounted If handed a collection and a publish function the HTTP.publish will mount on follow urls and methods:

• GET - /api/list - all published data
• POST - /api/list - insert a document into collection
• GET - /api/list/:id - find one published document
• PUT - /api/list/:id - update a document
• DELETE - /api/list/:id - remove a document

  myCollection = new Meteor.Collection('list');

  // Add access points for `GET`, `POST`, `PUT`, `DELETE`
  HTTP.publish({collection: myCollection}, function(data) {
    // this.userId, this.query, this.params
    return myCollection.find({});
  });

###Publish view only If handed a mount name and a publish function the HTTP.publish will mount:

• GET - /mylist - all published data

  myCollection = new Meteor.Collection('list');

  // Add access points for `GET`
  HTTP.publish({name: 'mylist'}, function(data) {
    // this.userId, this.query, this.params
    return myCollection.find({});
  });

###Create Update Delete only If handed a collection only the HTTP.publish will mount:

• POST - /api/list - insert a document into collection
• PUT - /api/list/:id - update a document
• DELETE - /api/list/:id - remove a document

  myCollection = new Meteor.Collection('list');

  // Add access points for `POST`, `PUT`, `DELETE`
  HTTP.publish({collection: myCollection});

##Publish scope The publish scope contains different kinds of inputs. We can also get user details if logged in.

• this.userId The user whos id and token was used to run this method, if set/found
• this.query - query params ?token=1 -> { token: 1 }
• this.params - Set params /foo/:name/test/:id -> { name: '', id: '' }

##Passing data via header From the client:

  HTTP.get('/api/list', {
    data: { foo: 'bar' }
  }, function(err, result) {
    console.log('Content in parsed json: ');
    console.log(result.data);
  });

HTTP Server method:

  HTTP.publish({collection: myCollection}, function(data) {
    // data === { foo: 'bar' }
  });

##Authentication For details on authentication of http calls please read the Authentication part in HTTP.methods package

The publish will have the this.userId set if an authenticated user is making the request.

##Format handlers The query parametre format is used to set different output formats. The buildin format is json (EJSON since we are on Meteor)

Example: (json is buildin)

  // Format the output into json
  HTTP.publishFormats({
    'json': function(result) {
      // Set the method scope content type to json
      this.setContentType('application/json');
      // Return EJSON string
      return EJSON.stringify(result);
    }
  });

GET url: /api/list?format=json

    HTTP.get('/api/list', {
      params: {
        format: 'json'
      }
    }, function(err, result) {
      console.log('Back from update');
      if (err) {
        console.log('Got error');
      }
      console.log('Got json back: ' + result.content);
    });

##Unpublish For api integrity theres added an HTTP.unpublish method that takes a collection or name of mount point to remove.

##API Documentation

Here