SDK Go de Unimatrix

Installation

Le SDK Unimatrix pour Golang utilise Go Modules, disponible sur le répertoire public Github.

Exécutez la commande suivante pour ajouter uni-go-sdk comme dépendance à votre projet :

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

Utilisation

L'exemple suivant montre comment utiliser le SDK Unimatrix Go pour interagir avec les services Unimatrix.

Initialiser un client

package main

import (
    "fmt"
    "github.com/unimtx/uni-go-sdk"
)

func main() {
    client := uni.NewClient("votre access key id", "votre access key secret") // si vous utilisez le mode d'authentification simple, passez juste le premier paramètre
}

ou vous pouvez configurer vos identifiants par des variables d'environnement :

export UNIMTX_ACCESS_KEY_ID=votre_access_key_id
export UNIMTX_ACCESS_KEY_SECRET=votre_access_key_secret

Envoyer SMS

Envoyez un message texte à un seul destinataire.

package main

import (
    "fmt"
    "github.com/unimtx/uni-go-sdk"
)

func main() {
    client := uni.NewClient()

    res, err := client.Messages.Send(&uni.MessageSendParams{
        To: "+1206880xxxx",  // au format E.164
        Text: "Votre code de vérification est 2048.",
    })
    if err != nil {
        fmt.Println(err)
    } else {
        fmt.Println(res)
    }
}

Envoyez un message en utilisant un modèle avec des variables.

client.Messages.Send(&uni.MessageSendParams{
    To: "+1650253xxxx",
    Signature: "Unimatrix",
    TemplateId: "pub_otp_fr",
    TemplateData: map[string]string {"code": "2048"},
})

Envoyer OTP

Envoyez un code à usage unique (OTP) à un destinataire. L'exemple suivant enverra un code de vérification généré automatiquement à l'utilisateur.

package main

import (
    "fmt"
    "github.com/unimtx/uni-go-sdk"
)

func main() {
    client := uni.NewClient()

    res, err := client.Otp.Send(&uni.OtpSendParams{
        To: "+1206880xxxx",
    })
    if err != nil {
        fmt.Println(err)
    } else {
        fmt.Println(res)
    }
}

Vérifier OTP

Vérifiez le code à usage unique (OTP) fourni par un utilisateur. L'exemple suivant vérifiera si le code de vérification fourni par l'utilisateur est correct.

package main

import (
    "fmt"
    "github.com/unimtx/uni-go-sdk"
)

func main() {
    client := uni.NewClient()

    res, err := client.Otp.Verify(&uni.OtpVerifyParams{
        To: "+1206880xxxx",
        Code: "123456", // le code fourni par l'utilisateur
    })
    if err != nil {
        fmt.Println(err)
    } else {
        fmt.Println(res.Valid)
    }
}