SDK Go da Unimatrix

Instalação

O SDK Unimatrix para Golang utiliza Módulos Go, que estão disponíveis no repositório público Github.

Execute o seguinte comando para adicionar o uni-go-sdk como uma dependência ao seu projeto:

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

Uso

O exemplo a seguir mostra como usar o Unimatrix Go SDK para interagir com os serviços da Unimatrix.

Inicializar um cliente

package main

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

func main() {
    client := uni.NewClient("seu id de chave de acesso", "seu segredo de chave de acesso") // se usando o modo de autenticação simples, apenas passe o primeiro parâmetro
}

ou você pode configurar suas credenciais por variáveis de ambiente:

export UNIMTX_ACCESS_KEY_ID=seu_id_de_chave_de_acesso
export UNIMTX_ACCESS_KEY_SECRET=seu_segredo_de_chave_de_acesso

Enviar SMS

Envie uma mensagem de texto para um único destinatário.

package main

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

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

    res, err := client.Messages.Send(&uni.MessageSendParams{
        To: "+1206880xxxx",  // no formato E.164
        Text: "Seu código de verificação é 2048.",
    })
    if err != nil {
        fmt.Println(err)
    } else {
        fmt.Println(res)
    }
}

Enviar uma mensagem usando um template com variáveis.

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

Enviar OTP

Envie um código de passagem única (OTP) para um destinatário. O exemplo a seguir enviará um código de verificação gerado automaticamente para o usuário.

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)
    }
}

Verificar OTP

Verifique o código de passagem única (OTP) fornecido por um usuário. O exemplo a seguir verificará se o código de verificação fornecido pelo usuário está correto.

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", // o código fornecido pelo usuário
    })
    if err != nil {
        fmt.Println(err)
    } else {
        fmt.Println(res.Valid)
    }
}