Firmreader Docs Online logo

Go

Leer hoe je de Firmreader Go SDK installeert en gebruikt om berichten te maken, berichten te bekijken en API-fouten af te handelen met Go 1.21 of hoger.

Voor de Go SDK is Go 1.21+ vereist. Elke methode accepteert een context.Context, zodat je time-outs en annulering kunt toepassen.

Installeren

go get github.com/firmreader/firmreader-go

De client initialiseren

package main

import (
	"os"

	"github.com/firmreader/firmreader-go"
)

func main() {
	client := firmreader.NewClient(os.Getenv("FIRMREADER_API_KEY")) // fr_live_...
	_ = client
}

Een bericht maken

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)

Berichten weergeven

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)
}

Fouten afhandelen

De client retourneert een *firmreader.Error voor antwoorden die niet 2xx zijn. Gebruik errors.As om de status en code uit te lezen.

var apiErr *firmreader.Error
if errors.As(err, &apiErr) {
	fmt.Printf("%d: %s\n", apiErr.Status, apiErr.Code)
}

Stel firmreader.WithIdempotencyKey("...") in bij elke schrijfbewerking, zodat nieuwe pogingen geen dubbele berichten maken.

Last updated on