ngapi

v0.1.8

Published

3 years ago

An AngularJS module that makes your APIs working in the Angular Way.

Downloads

0High
0Medium
0Low

iamblue

ngApi

An AngularJS module that makes your APIs working in the Angular Way. You only write html tag , DON'T NEED TO write too many Ajax by javascript.

Example:

<input type="" ng-model="loginname"/>
<input type="" ng-model="loginemail"/>
<input type="" ng-model="loginpassword"/>

<a ng-api="(loginname:string||loginemail:email||loginpassword:nospace)(post:/api/login)" api-success="if you have or not" api-error="if you have or not">send</a>

##Description

(loginname:string...):

loginname means it will retreive loginname (ng-model's data), and string means you will validate loginname (ng-model's data) whether be a string.
In this module, we have four validate methods initailly:
```
 1.email 
 2.number 
 3.string 
 4.nospace
    
```
If you want to expand validate methods, see
loginname, loginemail , loginpassword will be sent by ajax data , look like following:

    data:{
        loginname:loginname,
        loginemail:loginemail,
        loginpassword:loginpassword
    }

More infomations: see

(post:/api/login): post means it will post to /api/login.

Install

bower install ngapi

Add following into your Html <head>:

<script src="bower_components/ngapi/ngapi.js"></script>

Usage

Require ngapi and Inject the Services

Init:

angular.module('yourApp', ['ngapi'])

Setting API url:

For example: http://127.0.0.1:3000

  .constant('apiurl','http://127.0.0.1:3000')

If you have all of your api routes (json) from your api server, try that:

.constant('apiurl',{
  routes:'http://127.0.0.1:3000/youmeb/routes.json',
  //you can make many routes , ngapi will combine it to a scope.
});

`ng-api` style: ng-api = "(data)(api)"

data : (model_name : validate : validate_error_callback||.....)
1. model_name
2. validate
3. validate_error_callback:
api:

(request:path): request method: post , get , restfullogin
For example: post:/api/getnavs , get:/api/getnavs , restfullogin:/api/rest-auth/login ...etc
(routes.api.getnavs):
if you use:

.constant('apiurl',{
  routes:'http://127.0.0.1:3000/youmeb/routes.json',
  //you can make many routes , ngapi will combine it to a scope.
});

And the json content like that:

{
    api.getnavs: {
        path: "/api/getnavs",
        methods: [
            "get"
        ]
    }
}

You can use (routes.api.getnavs) , it will help you retreive get and /api/getnavs data.

success callback / error callback:

You can use api-success or api-error do it.

<a ng-api="(loginname:string||loginemail:email||loginpassword:nospace)(post:/api/login)" api-success="your scope function" api-error="your scope function">send</a>

Expand

If you want to expand validate libery:

.constant('apivalidate',{
    date:function(v){
        // your new validate method
    }
});

If you want to authentication login by RESTful architecture

On a common REST-authentication architecture, we need browser make a Cnonce constant and crypo your "password code"+snonce( nonce form server)+c_nonce and send it back your server.

Step1: Make a Cnonce :

.constant('apicnonce','cnonce')  // 'cnonce' can include a function which will make a new cnonce code

Step2: Add a apicrypto algo:

.constant('apicrypto',function(){
    //your crypto algo, for example :sha1,md5 ... etc
})

###Reference:

About REST-Authentication, I sugguest you to read following paper:

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme