url-api
Format and generate the urls for an API service
This package will format all the string patterns used in frameworks like express into full urls like this.
Usage
//Import dependencies var url_api = ; //Url object var url_obj = protocol: 'https' hostname: 'mywebsite.com' ; //Api urls var api = projects: '/projects/:project' home: '/' users: '/users/:user' ; //Simple api;// { // projects: 'https://mywebsite.com/projects/{project}',// home: 'https://mywebsite.com/',// users: 'https://mywebsite.com/users/{user}' // } //With options;// { // projects: 'https://mywebsite.com/projects/{{project}}',// home: 'https://mywebsite.com/',// users: 'https://mywebsite.com/users/{{user}}' // }
API
url_api(url_obj, api[, opt])
Returns a new object with all the pathnames formatted. This method accepts the following arguments:
url_obj
: a url object with the API host information.api
: an object with all the paths strings of your RESTful API service.opt
(optionally): an object with the options:find
: a regular expression to find the pattern parameters. Default is set to find the parameters starting with:
.prefix
: the formatted pattern parameter prefix. Default is{
.suffix
: the formatted pattern parameter suffix. Default is}
.
License
MIT LICENSE © Josemi Juanes.