Explore as APIs da Vonage com o SDK do Vonage Go

Temos o prazer de anunciar a disponibilidade imediata do SDK do Vonage Go. Adoramos nossas comunidades de desenvolvedores, e nossa missão é criar ferramentas que facilitem a vida deles. Sabemos que cada vez mais “gophers” estão adotando essa excelente pilha de Go e começando a usar nossas APIs. É possível fazer isso diretamente no Go, mas, ao criar um SDK para que todos possam experimentar, esperamos que isso ajude vocês a lançarem seus produtos mais rapidamente!

Destaques do SDK

Quais são as vantagens de usar o SDK do Vonage Go? Em primeiro lugar, ele cuida dos detalhes para você. Para linguagens fortemente tipadas, como o Go, ter modelos de dados definidos e um código capaz de enviar e receber as estruturas de dados esperadas pela API sem que você precise ler a documentação da API é sempre uma vantagem.

O SDK depende de código gerado a partir de nossas descrições da OpenAPI, o que significa que ele é preciso, está de acordo com a documentação e pode ser atualizado mais rapidamente quando novos recursos são adicionados.

Além da documentação do pacote, o SDK vem com um conjunto de exemplos para mostrar como realizar as principais tarefas nesta biblioteca.

Exemplo rápido: enviar um SMS

Nunca vou me cansar de digitar código e ver uma mensagem chegar no meu celular! Enviar um SMS costuma ser nosso exemplo de introdução, e com o SDK do Go, é bem simples:

package main

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

func main() {
	auth := vonage.CreateAuthFromKeySecret(API_KEY, API_SECRET)
	smsClient := vonage.NewSMSClient(auth)
	response, _ := smsClient.Send("44777000000", "44777000777", "Hi from golang", vonage.SMSOpts{})

	if response.Messages[0].Status == "0" {
		fmt.Println("Message sent")
	}
}

Também tentamos levar em conta como o SDK se encaixará nas Applications que os desenvolvedores utilizam. Às vezes, o SDK faz tudo o que você precisa, mas, em outras ocasiões, é importante poder substituir parte do comportamento padrão da biblioteca quando o Mundo Real (TM) atrapalha!

Para isso, você pode acessar pequenas funcionalidades, como obter um JWT gerado para usar em suas solicitações:

package main

import (
	"fmt"

	"github.com/vonage/vonage-go-sdk/jwt"
)

func main() {
    privateKey, _ := ioutil.ReadFile(PATH_TO_PRIVATE_KEY_FILE)
    g := jwt.NewGenerator(APPLICATION_ID, privateKey)

    token, _ := g.GenerateToken()
    fmt.Println(token)
}

Isso pode ser útil caso você precise alterar alguma coisa nas chamadas de API que você faz.

Agradecemos suas contribuições

O SDK do Go ainda está em fase inicial, mas adoraríamos saber sua opinião caso você resolva experimentá-lo.

Issues e pull requests no repositório do GitHub são muito bem-vindos, é claro, e também ficaríamos super felizes em saber o que você criou; então, mande um tweet para @VonageDev e conte para a gente!