SDK Go
Le SDK officiel Go wrappe l'API REST avec un type-checking idiomatique. Toutes les actions du dashboard sont disponibles.
Installation
$ go get github.com/di2amp/sdk-go
Authentification
Toutes les requêtes se font avec un token API que vous générez dans le dashboard, onglet « API tokens ».
import "github.com/di2amp/sdk-go"
client := paas.NewClient( paas.WithToken(os.Getenv("PAAS_API_TOKEN")), )
client := paas.NewClient( paas.WithToken(os.Getenv("PAAS_API_TOKEN")), )
Lister les apps
apps, err := client.Apps.List(ctx)
if err != nil { log.Fatal(err) }
for _, app := range apps {
fmt.Println(app.Name, app.URL)
}
Créer une app
app, err := client.Apps.Create(ctx, &paas.CreateAppRequest{
Name: "monsite",
Region: "fr-1",
})
Streaming des logs
Les logs en temps réel arrivent via un stream Server-Sent Events. Le SDK le wrappe pour rester idiomatique.
stream, _ := client.Logs.Stream(ctx, "monsite")
for line := range stream.Lines() {
fmt.Println(line)
}
Gestion des erreurs
Toutes les erreurs renvoyées par l'API sont mappées en exceptions typées. Vous catchez par catégorie : AuthError, RateLimitError, NotFoundError, ValidationError, ServerError.
Code source et référence complète
Le SDK est open source (Apache 2.0). Bug, suggestion, ou contribution : sur le repo GitHub.
- Repo : github.com/di2amp/sdk-go
- Référence générée : Go API reference
- Changelog : Voir les versions