Home › Key concepts › APIs and contracts

Key concept · Crawl (beginner) · the same on every platform

APIs and contracts

A promised way for programs to talk, which you change carefully.

What it is

An API is a set of requests a service accepts and responses it returns, often over HTTP with JSON (REST). Its contract is the exact shape of those messages. Changing it can break every caller, so APIs are versioned.

Why it matters

Every app, pipeline and agent tool is an API call. Clear contracts keep systems loosely joined.

An example

GET /orders/123 returns the order as JSON; v2 adds a field without removing any.

The common mistake

Renaming a field in a response and breaking three other teams overnight.

Where you meet it on each platform

The idea stays the same; only the product name changes.

JobAWSAzureGoogle CloudDatabricksOpen source
Run an appsomewhere for your code to live and answer requestsLambda / ECS FargateContainer Apps / FunctionsCloud RunDatabricks AppsDocker

Related ideas

Where it shows up

Part of the Crawl level on these paths: AI Engineering (engineering basics) · Software Engineering (building services).