Fizzy SDK

Official multi-language SDK for the Fizzy API.

Languages

Go

import "github.com/basecamp/fizzy-sdk/go/pkg/fizzy"

client := fizzy.NewClient(cfg, fizzy.NewStaticTokenProvider(token))
account := client.ForAccount("12345")

boards, err := account.Boards.List(ctx, nil)

TypeScript

import { createFizzyClient } from "@37signals/fizzy";

const client = createFizzyClient({ accessToken: "tok_..." });
const account = client.forAccount("12345");

const boards = await account.boards.list();

Ruby

require "fizzy"

client = Fizzy.client(access_token: "tok_...")
account = client.for_account("12345")

boards = account.boards.list

Swift

import Fizzy

let client = FizzyClient(accessToken: "tok_...", userAgent: "MyApp/1.0")
let account = client.forAccount("12345")

let boards = try await account.boards.list()

Kotlin

val client = FizzyClient {
    accessToken("tok_...")
}
val account = client.forAccount("12345")

val boards = account.boards.list()

Features

Feature	Go	TS	Ruby	Swift	Kotlin
Bearer token auth	✓	✓	✓	✓	✓
Cookie session auth	✓	✓	✓	✓	✓
Magic link flow	✓	✓	✓	✓	✓
Retry + backoff	✓	✓	✓	✓	✓
Pagination	✓	✓	✓	✓	✓
ETag caching	✓	✓	✓	✓	✓
Webhook verification	✓	✓	✓	✓	✓
Observability hooks	✓	✓	✓	✓	✓
Structured errors	✓	✓	✓	✓	✓
Circuit breaker	✓	✓	✓	✓	✓

License

MIT