austack-node v2.0.3

Austack

Node.js client for Austack. Secure APIs with tokens.

Welcome

npm install austack-node

Usage

var austack = require('austack-node')(CLIENT_ID, CLIENT_SECRET);

Get CLIENT_ID, CLIENT_SECRET from Austack.

Login > Application > New Application > Settings

austack#getToken()

生成一个新的token

返回值:

• Promise\<String> token

示例:

austack.getToken()
    .then(function(token){
        console.log('token: ' + token)
    })

austack#decode(token)

对token解码

参数:

• token \<String>

返回值:

• Object token对应的Object: header, payload 和 signature。

示例:

austack.decode(token)
    .then(function(decoded){
        console.log('decoded: ' + JSON.stringify(decoded))
    })

austack#verify(token)

对token进行验证

参数:

• token \<String>

返回值:

• Promise\<Object> token的payload

如果验证通过，Promise被resolve。验证没有被通过，Promise被reject。

示例:

austack.verify(token)
    .then(function(verifed){
        console.log('verifed: ' + verifed)
    })

austack#auth(req)

验证http request header包含的authorization信息

参数:

• req \<Object>

返回值:

• Promise\<>

如果验证通过，Promise被resolve, 否则被reject.

示例:

var ctx = {
    req: {
        headers: {
            authorization: 'Bearer ' + token
        }
    }
}
adminAustack.auth(ctx)
    .then(function(result){
        // 验证通过
    }, function(err){
        // 验证失败，token失效、信息缺失等原因
    });

Express Austack中间件, Koa Austack中间件

austack#getApplication(token)

获得应用信息

参数:

• token \<String>

返回值:

• Promise\<Object> 获得CLIENT_ID所属的应用的信息，包含:

示例:

austack.getApplication(token)
    .then(function(appInfo){
        console.log('appInfo: ' + appInfo)
    })

austack#getRepo(token)

获取数据集名称, 数据集是Austack提供的数据存储服务。在控制台上，提供数据集表结构的定义。数据集可以用来存储数据，每个用户拥有一个数据集，用户可以创建多个应用，数据集在这些应用中是共享的。

参数:

• token \<String>

返回值:

• Promise\<String> 数据集名称

示例:

austack.getRepo(token)
    .then(function(repoName){
        console.log('repoName: ' + repoName)
    })

austack#getShape(token, repoName)

获取数据集元数据

参数:

• token \<String>
• repoName \<String> 数据集名称，通过 getRepo 或者 getApplication 获得。

返回值:

• Promise\<Object>

元数据包含：mSchema(数据集表结构定义)、type(类型)、name(名称)、created(创建时间)和modified(最后更新时间)。

示例:

austack.getShape(token, repoName)
    .then(function(shapeInfo){
        console.log('shapeInfo: ' + shapeInfo)
    })

austack#getRepoData(token, repoName, options)

获取数据集数据

参数:

• token \<String>
• repoName \<String> 数据集名称，通过 getRepo 或者 getApplication 获得。
• 可选 options \<Object> 过滤条件 {q, limit, page, fields, sortby}, options 可以用来做多条件查询。

返回值:

• Promise\<Object>

标准返回值

{
  "total": 12, // 所有数据条数
  "total_page": 12, // 所有的页数
  "current_page": 1, // 当前页数
  "rc": 1, // 返回代码, 1是正常返回，其他值代表返回异常
  "data": [ // 数据
    {
      "_id": "xxx",
      "createAt": "2017-05-30T02:58:17.470Z",
      "textMessage": "bar",
      "uid": "foo",
      "direction": "inbound"
    }
  ]
}

示例:

austack.getRepoData(token, repoName, {
        limit: 1,
        fields: 'uid textMessage direction createAt',
        page: 1,
        sortby: '-createAt' // 默认按照字段名升序，如果前面添加'-'则使用降序
    })
    .then(function(repoData){
        console.log('repoData: ' + repoData)
    })

austack#saveRepoData(token, repoName, data)

更新或者创建新数据

参数:

• token \<String>
• repoName \<String> 数据集名称，通过 getRepo 或者 getApplication 获得。
• data \<Object>

返回值:

• Promise\<Object> 已创建或更新的数据记录。

data必须包含的字段: uid, textMessage, direction.

示例:

austack.saveRepoData(token, repoName, {
        "_id": "xxxx", // 可选
        "textMessage": "barbar",
        "uid": "foo",
        "direction": "inbound",
    })
    .then(function(result){
        console.log('result: ' + result)
    })

austack#getRepoDataById(token, repoName, objectId)

获取指定Id的数据记录

参数:

• token \<String>
• repoName \<String> 数据集名称，通过 getRepo 或者 getApplication 获得。
• objectId \<String> 数据记录的唯一标识

返回值:

• Promise\<Object> 如果该记录存在，Promise被resolve并返回该数据，否则Promise被reject。

示例:

austack.getRepoDataById(token, repoName, _id)
    .then(function(doc){
        console.log('docInfo: ' + doc)
    })

LICENSE

MIT