1.0.4 • Published 3 years ago

showapirequest_nodejs v1.0.4

Weekly downloads
6
License
MIT
Repository
github
Last release
3 years ago

仅适用于调用showapi.com的接口! ES6 await async语法的Promise版本,请求库使用axios axios 文档地址

安装

yarn

yarn add showapirequest_nodejs

npm

npm i showapirequest_nodejs

使用示例

调用二维码识别接口

const fs = require('fs')
const ShowapiRequest = require('showapirequest_nodejs')

//创建请求对象
const sdk = new ShowapiRequest(
  'https://route.showapi.com/887-2',//接口地址
  'appId',//替换为真实的appId
  'sign'//替换为真实的密钥
)

sdk
  .addFilePara('img', './static/xxx.png')//添加文件参数
  .post()//post方式发送请求,返回axios.post()的Promise
  .then((res) => {
    console.info("#####result:",res.data)
    console.info("#######axios all response:",res)
  })
  .catch((error) => {
    console.error(error)
  })

调用生成二维码接口

const fs = require('fs')
const ShowapiRequest = require('showapirequest_nodejs')

//创建请求对象
const sdk = new ShowapiRequest(
  'https://route.showapi.com/887-1',//接口地址
  'appId',//替换为真实的appId
  'sign'//替换为真实的密钥
)

sdk
  .addTextPara('content','https://baidu.com')//添加普通参数
  .get()//get方式发送请求,返回axios.get()的Promise
  .then((res) => {
    console.info("#####result:",res.data)
    console.info("#######axios all response:",res)
  })
  .catch((error) => {
    console.error(error)
  })

调用二维码识别接口,文件转base64传参方式

const fs = require('fs')
const ShowapiRequest = require('showapirequest_nodejs')

//创建请求对象
const sdk = new ShowapiRequest(
  'https://route.showapi.com/887-4',//接口地址
  'appId',//替换为真实的appId
  'sign'//替换为真实的密钥
)

sdk
  .addBase64Para('imgData','./static/xxx.png')//添加base64参数
  .post()//post方式发送请求,返回axios.post()的Promise
  .then((res) => {
    console.info("#####result:",res.data)
    console.info("#######axios all response:",res)
  })
  .catch((error) => {
    console.error(error)
  })

兼容性

本sdk使用了 ES6 Promises以及es6 async await特性, 请确保你的环境支持它

Classes

Functions

ShowapiSDK

Kind: global class

new ShowapiSDK(url, appId, sign, timeout)

ShowapiSDK构造方法

ParamTypeDefaultDescription
urlstring接口调用地址
appIdint应用id
signstring应用sign
timeoutint30000超时毫秒,默认为30秒

showapiSDK.setTimeout(timeout)

设置超时,针对ShowapiSDK对象生命周期有效

Kind: instance method of ShowapiSDK

ParamTypeDescription
timeoutint超时毫秒

showapiSDK.addTextPara(name, value) ⇒

添加一个普通参数,每次post或者get后已添加参数会清空

Kind: instance method of ShowapiSDK
Returns: this

ParamType
nameString
valueString

showapiSDK.addFilePara(name, filePath) ⇒

添加一个文件参数,每次post后已添加参数会清空

Kind: instance method of ShowapiSDK
Returns: this

ParamTypeDescription
nameString
filePathString文件绝对路径

showapiSDK.addBase64Para(name, filePath) ⇒

添加一个base64参数,每次post或者get后已添加参数会清空

Kind: instance method of ShowapiSDK
Returns: this

ParamTypeDescription
nameString
filePathString需要转为base64字符串的文件路径

showapiSDK.post() ⇒ Promise

以post方式发送请求,使用axios包

Kind: instance method of ShowapiSDK
Returns: Promise - axios.post()

showapiSDK.get() ⇒ Promise

以get方式发送请求,使用axios包

Kind: instance method of ShowapiSDK
Returns: Promise - axios.get()

1.0.4

3 years ago

1.0.3

4 years ago

1.0.2

4 years ago

1.0.1

4 years ago

1.0.0

4 years ago