Tech watch

API Design

Designing API contracts, errors and behavior for consumers.

29 Oct 2026Article

ActivityPub: a federated protocol with formal change rules

The W3C repository presents ActivityPub, a decentralized social networking protocol that combines a client-to-server API with a federated server-to-server API. Built on the ActivityStreams 2.0 JSON-LD format, it supports extensible activity descriptions and different kinds of social applications.

The repository also explains how to evolve a published recommendation: clarifications belong in the Primer, corrections follow an errata process, and breaking changes require a new working group. That formal governance reflects the deployment cost of changing a protocol used by many independently operated servers.

ActivityPub JSON-LD API Design

29 Oct 2026Article

AT Protocol: shared lexicons for publishing and indexing

standard.sitePermalink

Standard.site graphic presenting shared lexicons for publishing on AT Protocol, with part of a publication schema visible.

Standard.site proposes shared lexicons for publishing platforms on AT Protocol. The goal is to give indexers and tools a common schema while making content easier to discover and move between hosts.

The standard describes metadata for publications, documents, and subscriptions without prescribing a content format. Each platform can choose which lexicons to implement. Verification uses a /.well-known/site.standard.publication route to link a domain to its publication, and an HTML tag to associate a document with its AT-URI.

AT Protocol API Design

13 Feb 2025Repository

Next Zod Route: type and validate Route Handlers

github.comPermalink

Next Zod Route validates parameters, query strings and request bodies with Zod. Middleware and response handling help centralize conventions across Next.js API routes.

Next.js TypeScript API Design