Go
Ev rûpel ji Îngilîzî hatiye wergerandin. Heke her du ji hev cuda bin, rûpela Îngilîzî rast e. Rûpela Îngilîzî bixwîne
Pirtûkxaneya Go pakêta lingara ye di modûla github.com/Spinning-Cat-Studios/lingara_api_clients/go de. Ew Go 1.23 an nûtir hewce dike û tenê pirtûkxaneya standard bi kar tîne.
Çawa tê bikaranîn
- Her bang pêşî
context.Contextdigire. Ji bo betalkirina bangê context-ê betal bike; xeletiya ku tu vedigerînî ya context-ê bi xwe ye, ji ber vê yekêerrors.Is(err, context.Canceled)dixebite. - Bang hevdem in. Dema ku tu çend bangan bi hev re dixwazî, wan di goroutine-an de bixebitîne; parvekirina xerîdarekî ewle ye.
- Herikînek bi
for ev, err := range s.Events()tê xwendin, û her bûyer bi type switch tê hevberkirin. Wê bidefer s.Close()bigire. - Xeletî çar cure ne ku navrûya
lingara.Errorparve dikin. Ji bo gihîştina yekêerrors.Asbi kar bîne; dema ku API tu sekinandinek nebêje,RetryAfternile. - Vebijark fonksiyonel in:
lingara.WithHTTPClientderbas bike da kuhttp.Client-a xwe bi kar bînî. Wê demêTimeout-a wê her bangê sînor dike, herikîn jî tê de.
Mînakên li jêr modûlê saz dikin, xerîdarekî diafirînin, lîsteyeke ferhengê diherikînin û xeletiyekê birêve dibin.
Go
go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6Go
import (
"os"
lingara "github.com/Spinning-Cat-Studios/lingara_api_clients/go"
)
client, err := lingara.New(
lingara.WithClientCredentials(os.Getenv("LINGARA_CLIENT_ID"), os.Getenv("LINGARA_CLIENT_SECRET")),
)
if err != nil {
return nil, err
}Go
count := uint8(8)
s, err := client.GenerateVocabulary(ctx, lingara.VocabRequest{Level: 2, SourceLang: "en", TargetLang: "zh", Count: &count})
if err != nil {
return err
}
defer s.Close()
for ev, err := range s.Events() {
if err != nil {
return err
}
if item, ok := ev.(lingara.GenerateVocabularyEventItem); ok {
fmt.Println(item.Data.Word, item.Data.Translation)
}
}Go
_, err := client.GetUsage(ctx)
var apiErr *lingara.APIError
var oauthErr *lingara.OAuthError
var maintenance *lingara.MaintenanceError
var transport *lingara.TransportError
switch {
case err == nil:
case errors.As(err, &apiErr):
// A refusal from the API: Status, Code (stable) and Message (localised).
fmt.Println(apiErr.Status, apiErr.Code, apiErr.Message)
if apiErr.RetryAfter != nil {
fmt.Println("retry after", *apiErr.RetryAfter)
}
case errors.As(err, &oauthErr):
// The token endpoint refused the credentials or the scopes.
fmt.Println(oauthErr.Status, oauthErr.ErrorCode, oauthErr.Description)
case errors.As(err, &maintenance):
fmt.Println("under maintenance")
if maintenance.RetryAfter != nil {
fmt.Println("retry after", *maintenance.RetryAfter)
}
case errors.As(err, &transport):
// No usable answer: connect, tls, reset, timeout, and so on.
fmt.Println("transport:", transport.Kind)
default:
// ctx was cancelled or timed out: errors.Is(err, context.Canceled).
fmt.Println(err)
}