Go
Apprenez à installer et utiliser le SDK Go de Firmreader, requis avec Go 1.21 ou ultérieur, pour créer et lister des publications et gérer les erreurs d’API.
Le SDK Go requiert Go 1.21 ou une version ultérieure. Chaque méthode accepte un context.Context, ce qui vous permet d’appliquer des délais d’expiration et une annulation.
Installer
go get github.com/firmreader/firmreader-go
Initialiser le client
package main
import (
"os"
"github.com/firmreader/firmreader-go"
)
func main() {
client := firmreader.NewClient(os.Getenv("FIRMREADER_API_KEY")) // fr_live_...
_ = client
}
Créer une publication
post, err := client.Posts.Create(ctx, &firmreader.PostParams{
ChannelID: "ch_company_news",
Title: "Welcome to Firmreader",
Body: "We're excited to announce our new internal communications platform.",
Priority: "normal",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("Published post %s\n", post.ID)
Lister les publications
posts, err := client.Posts.List(ctx, &firmreader.ListParams{
ChannelID: "ch_company_news",
Limit: 20,
})
if err != nil {
log.Fatal(err)
}
for _, post := range posts.Data {
fmt.Println(post.Title)
}
Gérer les erreurs
Le client renvoie une *firmreader.Error pour les réponses qui ne sont pas 2xx. Utilisez errors.As pour lire le statut et le code.
var apiErr *firmreader.Error
if errors.As(err, &apiErr) {
fmt.Printf("%d: %s\n", apiErr.Status, apiErr.Code)
}
Définissez firmreader.WithIdempotencyKey("...") sur tout appel d’écriture afin que les nouvelles tentatives ne créent pas de publications en double.
Last updated on
