Firmreader Docs Online logo

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