# rpc

## Setup

	npm install rpc

## Usage

	app = require( "connect" )()
	url_path = "/api/"					// The url path prefix to watch for and handle
	api_path = "/disk/path/to/module"	// location of handler module
	app.use( require( "rpc" )( url_path api_path ) )

## API handler

Your API handler should be a module that can be loaded with require()
and should look something like this:

	module.exports = function( input, okay, fail ) {
		let action = input.action
		if( action == "ping" ) {
			okay( "pong" );
		} else {
			fail( "Unrecognized action: " + action );
		}
	}

The JSON response to the browser will look something like this if
you call okay():

	{ error: null, data: "pong" }

or this if you call fail():

	{ error: "Unrecognized action: foo", data: null }


## Options

To let your api handle calls from other domains:

	require( "rpc" )( url_path, api_path, { cors: true } );