concept · weight 9

APIs

Contracts that let separate software systems talk to each other.

#apis#integration#webupdated 06-10-2026

An API (Application Programming Interface) is a defined contract for how one system requests work or data from another. On the web, that contract is usually expressed over HTTP with JSON payloads.

Common styles

StyleShape
RESTResources addressed by URL, HTTP verbs for actions
GraphQLSingle endpoint, client specifies the exact data graph
RPCCall named procedures (gRPC, JSON-RPC)
WebhooksServer calls you when an event happens

What a good contract specifies

  • Endpoints and the resources they expose.
  • Auth — API keys, OAuth tokens, or signed requests.
  • Request/response schemas and error formats.
  • Rate limits and versioning strategy.

APIs are the connective tissue behind agent tools like Claude Code, which call model and platform APIs under the hood.