node-api-connector

usage

1. 安装

    npm install node-api-connector

2. 添加到 express

    var g = new guard({
        PACKAGE_HOME: __dirname + '/package',
        /* api 配置 */
        api: {
            use: function(appid, callback) {
                callback(null, {
                    'store': true,
                    'wx_conf': true,
                    'wx_oauth': true,
                    'wx_pay': true
                });
            },
   
            conf: {
                get: function(appid, config, callback) {
                    for(var key in config){
                        if(key == 'appid'){
                             config['appid'] = 'wx50d746e9d0f0af1d';//'wx22fb445469f289a2';
                        }
                    }
                    callback(null, config);
                }
            },
   
            data: {
                save: function(appid, apiname, data,callback){
                    console.log('==== data ====');
                    console.log(appid + ':' + apiname);
                    console.log(data);
                    callback(null,null);
                }
            },
   
            called: function(appid,apiname,ip,refer){
                //TODO
            }
        },
   
        /* 保存API返回数据*/
        data: function(appid,apiname,data,callback){
            callback(null);
        }
    });
    app.use(g.proxy);
   	
   	

   opt 说明:

   • PACKAGE_HOME: 放置 package 的根目录;
   • api.use: 根据 appid 获取 enabled 的 api
   • get_conf: 获取通用设置

endpoints

• 前端页面的 js 库

  endpoint: /mkit.js
  method: GET
  验证: none
  参数:
  none 说明:
  前端 js 类库
  测试:
  http://localhost:8000/mkit.js

• 前端 js库加载的函数库

  endpoint: /{appid}/fn.js
  method: GET
  验证: none
  参数:
  appid: appid, 必填
  说明:
  前端 api.js 加载完成之后会加载此文件, 在添 mkit 中添加指定app的前端接口
  测试:
  http://localhost:8000/foo/fn.js

• 前端页面函数库掉用的接口地址

  endpoint: /{appid}/endpoint/{wx_conf}
  method: GET
  验证: none
  参数: appid: appid, 必填
  说明:
  不同 API 接口被前端调用的中间地址, 服务器根据此地址转发到真正的
  地址 (manifest.json 文件中)上
  测试:
  http://localhost:8000/foo/endpoint/wx_conf

• 获取所有已公开的API列表

  endpoint: /api/list
  验证: none
  参数:
  none
  说明:
  获取所有已公开的API列表
  测试:
  http://localhost:8000/api/list

• 获取某个 API 详情

  endpoint: /api/{apiname}
  验证: none
  参数:
  apiname: api name, 必填
  说明:
  获取某个API详情, 包括标题, 描述, 及配置信息等, 但不包含 doc
  测试:
  http://localhost:8000/api/wechat_conf

• 获取某个 API markdown doc

  endpoint: /api/{apiname}/doc
  验证: none
  参数:
  apiname: api name, 必填
  说明:
  获取某个 API markdown content
  测试:
  http://localhost:8000/api/wechat_conf/doc

• 获取某个 API 配置

  endpoint: /{uid}/{appid}/{apiname}/conf 方法: GET 验证: none
  参数:
  uid: 必填
  appid: 必填
  apiname: 必填
  说明:
  获取某个 API 配置
  测试:
  http://localhost:8000/uid/appid/store/conf

• 更新某个 API 配置

  endpoint: /{uid}/{appid}/{apiname}/conf 方法: POST 验证: none
  参数:
  uid: 必填
  appid: 必填
  apiname: 必填
  说明:
  更新配置到 API, 通过form key value提交, key 的约定形式见文档;