jonas.splinter
Search
Topic

APIs

How systems talk to each other: designing, documenting and using APIs. Front ends, back ends, workflows and AI assistants all depend on them.

An application programming interface is a contract between two pieces of software. One side promises which requests it accepts and what it returns, and the other side relies on that promise. On the web this usually means HTTP endpoints that exchange JSON. The OpenAPI Specification, maintained by the OpenAPI Initiative under the Linux Foundation, is the common way to describe such an API in a machine-readable file, from which documentation, tests and client code can be generated.

APIs are the glue in my kind of work. A front end with a separate Laravel back end, a workflow in n8n that moves data between services, an assistant that searches a directory through MCP: each depends on one system asking another for data in an agreed format.

What I value most in an API is predictability: a consistent response shape, clear versioning, and errors that say what went wrong instead of an empty result. A failure that looks like valid data is the most expensive kind, because nobody notices it until the numbers are wrong.

2 blog posts

Longer articles about APIs

3 updates

Everything I posted about APIs, newest first

jsplinter.nl

New post: how my projects post their own updates

New

My projects can now post to this feed themselves, and read it first so they don't repeat news or invent tags. The post explains the guardrails that make that safe without a review step. Blockspot and Automate & Tweak are already posting.

jsplinter.nl

My projects can now post updates here themselves

New

This feed now has its own API for my projects. Blockspot, VoucherAlarm and Automate & Tweak can send their news straight here, so new features show up on this site as soon as they ship.

Personal

An API-first rule for everything I run

New house rule: every system I run shares its data only through its own API. No shortcuts between systems, which keeps the whole setup simpler and safer.