node-qiniu-sdk

使用 ES2017 async functions 来操作七牛云，接口名称与官方接口对应，轻松上手，文档齐全

qiniu的官方sdk不太符合日常需要，所以有时间写了个模块，你也可去qiniu官方查看官方SDK

模块主要包含七牛云以下产品与服务：

• 对象储存 官方文档
• 融合CDN 官方文档
• 智能多媒体API 官方文档
• 内容审核 官方文档
• 智能日志管理平台 官方文档

安装

$ npm install node-qiniu-sdk

测试用例

某些请求是需要人民币的，不要频繁测试（单次测试的费用非常非常少）

目前测试用例共104个，如果api我还没有写出来，请先看对应的测试用例 DEBUG=test mocha可以查看操作返回的具体的数据

第一次测试会下载一些测试文件，如果网络不好会出现before部分超时，测试资源请看node-qiniu-sdk-resource

av.pm3u8测试接口有可能出现超时的情况

# 先配置你的/test/resource/qiniu.config.json文件再测试
# qiniu.config.json是放置AccessKey和SecretKey的配置文件
# 格式与qiniu.config.default.json相同，你需要配置你的qiniu.config.json
$ mocha

# 如果想看返回的数据信息可以加上DEBUG=test
$ DEBUG=test mocha

# 如果想看操作信息可以加上DEBUG=qiniu-sdk（例如：分片上传的步骤）
$ DEBUG=qiniu-sdk mocha

package.json

• 1.1.3版本以后使用node-request-slim

  本来使用的是request的，但是：

  1. 由于request模块在提交content-type为text/plain时，会对数据JSON.stringify，所以会多一对“"”分号
  2. request为防止url异常会把url给eccodeURIComponent

  这两点在某些请求时会出错，导致请求失败

• 1.6.0版本以后使用qiniu-auth模块加密

  把加密的部分单独拿出去做一个新的模块，方便其它开发者创建自己的七牛云请求模块

使用简介

每个方法都与官网的对应，更多方法可参考文档

const Qiniu = require('node-qiniu-sdk');
const qiniu = new Qiniu('<Your AccessKey>', '<Your SecretKey>');

// 所有的方法都返回promise，这里我就直接用await了

// 创建管理储存空间的对象
const bucket = qiniu.bucket('<存储空间名称>');

// 如果你之前没有存储空间，使用mk方法可以创建一个
await bucket.mk();

// 删除存储空间
await bucket.drop();

// 创建管理文件的对象
const file = qiniu.file('<存储空间名称>:<文件名称>');

// 上传文件，这里会使用流的形式上传
await file.upload({ path: '<本地文件路径>' });

// 删除文件
await file.delete();

请求错误

如果请求时，七牛云响应了错误信息（statusCode不为200或298）时，操作会抛出异常，这里用pandora推送数据失败举例：

其它错误码信息，请查看错误码快查

try {
  await pandora.send({
    // 前提是不存在名字为test的repo
    repoName: 'test',
    content: [
      { userName: '小张', age: 12, addresses: "beijing"},
      { userName: '小王', age: 13, addresses: "hangzhou"}
    ]
  });
} catch(error) {
  // error信息如下：
  // {
  //   statusCode: 404,
  //   body: {
  //     error: 'E18102: The specified repo "test" does not exist'
  //   },
  //   errmsg:	'资源不存在，包括空间资源不存在；镜像源资源不存在。'
  // }
}

各模块功能

image.processing图片处理介绍

processing处理参数详情

const Qiniu = require('node-qiniu-sdk');
await Qiniu.image.processing(common.url, {
  imageslim: true,  // 图片瘦身（imageslim）将存储在七牛的JPEG、PNG格式的图片实时压缩而尽可能不影响画质。
  imageView: { w: 200, h: 300 },  // 图片基本处理接口可对图片进行缩略操作，生成各种缩略图。
  imageMogr: { blur: '20x2', rotate: 45 }, // 图片高级处理接口为开发者提供了一系列高级图片处理功能，包括缩放、裁剪、旋转等。
  watermark: { image: 'https://odum9helk.qnssl.com/qiniu-logo.png', scale: 0.3 },  // 七牛云存储提供三种水印接口
  roundPic: { radius: 20 }  // 图片圆角处理

  // 不指定path、stream、saveas会返回处理语句的url

  // 指定path或stream会保存到本地（path和stream原理相同）
  // path: __dirname + '/processing.test.jpg',
  // stream: fs.createWriteStream(__dirname + '/processing.test.jpg'),

  // 指定saveas会把处理的结果保存到指定七牛云仓库
  // saveas: qiniu.saveas(common.bucketName, 'processing.jpg')
});

• 处理前：

• 处理后：

由于旋转后背景色自动填充为白色，请到这个链接查看圆角效果：链接

错误码快查

官方文档

如遇 5xx 系列错误，请将完整的错误信息（包括所有的 HTTP 响应头部）提交工单 给七牛云。

官方文档快捷方式

• API概览
• HTTP Headers
• 错误响应
• 数据格式
• HTTP Headers

LICENSE

MIT