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.
| Job | AWS | Azure | Google Cloud | Databricks | Open source |
|---|---|---|---|---|---|
| Run an appsomewhere for your code to live and answer requests | Lambda / ECS Fargate | Container Apps / Functions | Cloud Run | Databricks Apps | Docker |
Related ideas
Where it shows up
Part of the Crawl level on these paths: AI Engineering (engineering basics) · Software Engineering (building services).