Skip to main content
~/tags/api-design

#API Design

4 pages tagged across the site.

>> Blog

Endpoint maps over hand-rolled methods

When a client library wraps ~25 near-identical HTTP endpoints, describing them as data instead of writing 25 methods pays off — with one real trade-off.

>> Opinions

Give callers two error types, one extending the other

A single catch-all exception forces every call site to over-handle. Two types in a hierarchy let each caller pick its own granularity.

Generic returns can be the right call for a library you maintain alone

Typed response structs are the default advice. For a one-person library wrapping a churny upstream API, `(any, error)` was the cheaper long-term choice.

>> Projects

WazirX Go Connector

An open-source unofficial REST API client for the WazirX crypto exchange in Go, acknowledged by WazirX's co-founder.