SDK 接入

Java SDK

安裝

Uni Java SDK 使用 Maven 托管，可從公共 Maven 倉(cāng)庫(kù) 中獲得。

在項(xiàng)目中使用以下代碼添加 Maven 依賴：

    com.apistd.uni
    uni-sdk
    0.0.4

或使用 Gradle：

implementation "com.apistd.uni:uni-sdk:0.0.4"

使用示例

以下示例展示如何使用 Uni Java SDK 快速調(diào)用服務(wù)。

發(fā)送短信

import com.apistd.uni.Uni;
import com.apistd.uni.UniException;
import com.apistd.uni.UniResponse;
import com.apistd.uni.sms.UniSMS;
import com.apistd.uni.sms.UniMessage;

import java.util.HashMap;
import java.util.Map;

public class Example {
    public static String ACCESS_KEY_ID = "your access key id";
    private static String ACCESS_KEY_SECRET = "your access key secret";

    public static void main(String[] args) {
        // 初始化
        Uni.init(ACCESS_KEY_ID, ACCESS_KEY_SECRET); // 若使用簡(jiǎn)易驗(yàn)簽?zāi)Ｊ絻H傳入第一個(gè)參數(shù)即可

        // 設(shè)置自定義參數(shù) (變量短信)
        Map templateData = new HashMap();
        templateData.put("code", "6666");

        // 構(gòu)建信息
        UniMessage message = UniSMS.buildMessage()
            .setTo("your phone number")
            .setSignature("UniSMS")
            .setTemplateId("login_tmpl")
            .setTemplateData(templateData);

        // 發(fā)送短信
        try {
            UniResponse res = message.send();
            System.out.println(res);
        } catch (UniException e) {
            System.out.println("Error: " + e);
            System.out.println("RequestId: " + e.requestId);
        }
    }
}

Go SDK

安裝

Uni Go SDK 提供 Go Module，可從公共 Github 倉(cāng)庫(kù) 中獲得。

在項(xiàng)目中添加 uni-go-sdk 作為依賴：

go get github.com/apistd/uni-go-sdk

使用示例

以下示例展示如何使用 Uni Go SDK 快速調(diào)用服務(wù)。

發(fā)送短信

package main

import (
    "fmt"
    unisms "github.com/apistd/uni-go-sdk/sms"
)

func main() {
    // 初始化
    client := unisms.NewClient("your access key id", "your access key secret") // 若使用簡(jiǎn)易驗(yàn)簽?zāi)Ｊ絻H傳入第一個(gè)參數(shù)即可

    // 構(gòu)建信息
    message := unisms.BuildMessage()
    message.SetTo("your phone number")
    message.SetSignature("UniSMS")
    message.SetTemplateId("login_tmpl")
    message.SetTemplateData(map[string]string {"code": "6666"}) // 設(shè)置自定義參數(shù) (變量短信)

    // 發(fā)送短信
    res, err := client.Send(message)
    if (err != nil) {
        fmt.Println(err)
        return
    }
    fmt.Println(res)
}

Node.js SDK

安裝

Uni Node.js SDK 使用 npm 托管，可從公共 npm 倉(cāng)庫(kù) 中獲得。

在項(xiàng)目中添加 unisms 作為依賴：

npm i unisms

或使用 Yarn：

yarn add unisms

使用示例

以下示例展示如何使用 Uni Node.js SDK 快速調(diào)用服務(wù)。

發(fā)送短信

import UniSMS from 'unisms'

// 初始化
const client = new UniSMS({
  accessKeyId: 'your access key id',
  accessKeySecret: 'your access key secret',  // 若使用簡(jiǎn)易驗(yàn)簽?zāi)Ｊ秸?qǐng)刪除此行
})

// 發(fā)送短信
client.send({
  to: 'your phone number',
  signature: 'UniSMS',
  templateId: 'login_tmpl',
  templateData: {
    code: 8888,
  },
})
  .then(ret => {
    console.info('Result:', ret)
  })
  .catch(e => {
    console.error(e)
  })

如若遇到以下報(bào)錯(cuò)：

SyntaxError: Cannot use import statement outside a module

或報(bào)錯(cuò)：

TypeError: UniSMS is not a constructor

可以調(diào)整引用的方式為：

// import UniSMS from 'unisms'
const UniSMS = require('unisms').default

Python SDK

安裝

Uni Python SDK 使用 PyPI 托管，可從公共 PyPI 倉(cāng)庫(kù) 中獲得。

在項(xiàng)目中使用 pip 添加 unisms 作為依賴：

pip install unisms

使用示例

以下示例展示如何使用 Uni Python SDK 快速調(diào)用服務(wù)。

發(fā)送短信

from unisdk.sms import UniSMS
from unisdk.exception import UniException

# 初始化
client = UniSMS("your access key id", "your access key secret") # 若使用簡(jiǎn)易驗(yàn)簽?zāi)Ｊ絻H傳入第一個(gè)參數(shù)即可

try:
  # 發(fā)送短信
  res = client.send({
    "to": "your phone number",
    "signature": "UniSMS",
    "templateId": "login_tmpl",
    "templateData": {
      "code": 7777
    }
  })
  print(res.data)
except UniException as e:
  print(e)

PHP SDK

安裝

Uni PHP SDK 使用 Packagist 托管，可從公共 Packagist 倉(cāng)庫(kù) 中獲得。

使用 Composer 在項(xiàng)目中添加 apistd/uni-sdk 作為依賴：

composer require apistd/uni-sdk

使用示例

以下示例展示如何使用 Uni PHP SDK 快速調(diào)用服務(wù)。

發(fā)送短信

use Uni\Common\UniException;
use Uni\SMS\UniSMS;

// 初始化
$client = new UniSMS([
  'accessKeyId' => 'your access key id',
  'accessKeySecret' => 'your access key secret' // 若使用簡(jiǎn)易驗(yàn)簽?zāi)Ｊ秸?qǐng)刪除此行
]);

// 發(fā)送短信
try {
  $resp = $client->send([
    'to' => 'your phone number',
    'signature' => 'UniSMS',
    'templateId' => 'login_tmpl',
    'templateData' => [
      'code' => 7777
    ]
  ]);
  var_dump($resp->data);
} catch (UniException $e) {
  print_r($e);
}