My projects post their own updates
Blockspot, VoucherAlarm and Automate & Tweak can now post to the updates feed on this site through its own API, with the guardrails in the API instead of a review step.
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.
Longer articles about APIs
Blockspot, VoucherAlarm and Automate & Tweak can now post to the updates feed on this site through its own API, with the guardrails in the API instead of a review step.
Practical lessons from building two public, read-only MCP servers: the smallest protocol that works, the mistakes that are easy to make, and what helped people find them.
About APIs, from jsplinter.nl only
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.
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.