# api (10-api.org)

An API is a way for one program to ask another program for something. A person might say "the API" to mean a company's web service, like "Twitter's API" or "the weather API." They usually just mean a doorway they can use to get data or make something happen.

## What a model may hear
- Application Programming Interface (software engineering): treat the word as a formal contract between code modules, expecting endpoints, methods, schemas, and authentication flows
- web API / REST API (web development): assume HTTP endpoints returning JSON, with GET, POST, PUT, DELETE operations and status codes
- operating system API (systems programming): expect system calls, libraries, or kernel interfaces like POSIX or Win32
- library or package API (programming languages): look for function signatures, classes, and documentation of public methods
- API key or token (security and cloud services): assume the user needs credentials, rate limits, and billing controls

## Where people and models part ways
- Says: "Is the API down?"
  Means: Is the website or service not working?
  May be taken as: The model explains API status codes and debugging HTTP responses the person cannot access
  Say instead: "Is the website or service not working right now?"
- Says: "I need to build an API"
  Means: I need to make my data available to others
  May be taken as: The model generates a full technical specification with endpoints and authentication the person did not want
  Say instead: "I need a simple way for others to get data from my project"
- Says: "Does it have an API?"
  Means: Can I connect this to other tools I use?
  May be taken as: The model lists undocumented or deprecated endpoints, or assumes programming skill the person lacks
  Say instead: "Can this connect to other apps without coding?"
- Says: "Call the API"
  Means: Use the service
  May be taken as: The model writes code for an HTTP request instead of pointing to a no-code integration
  Say instead: "Use the service to get that information"

## Tips
- Say 'website service' or 'connection' if you do not want code
- Say 'no-code' or 'without programming' to block technical assumptions
- Say 'for beginners' or 'simplest way' to get the easiest path
- Ask 'can I do this in a browser?' to avoid being given scripts
- Say 'I do not code' early to reset the model's framing

## Often confused with
- SDK: a toolkit with code, not just a doorway
- endpoint: one specific URL, not the whole service
- webhook: the service calls you, not you calling it
- plugin: adds features inside an app, not a separate service
- database: stores data directly, not a layer on top
- interface: broader, includes screens people click