API Glossary · 60+ terms

Every API term, decoded.

Plain-English definitions for REST, JWT, OAuth, rate limiting, webhooks, GraphQL and 50+ more terms. Search or jump to a letter.

/

A

API

Concept / Tool

Application Programming Interface. A contract that lets one program ask another for data or to do work — usually over HTTP.

API Key

Auth

A long secret string the API issues to you. You send it in every request (in a header or URL param) so the API can identify and rate-limit you.

Access token

Auth

Short-lived credential issued after a successful OAuth flow. Usually a JWT. Expires; refreshed with a refresh token.

Async

Concept / Tool

A request that doesn't return the answer immediately — instead the API returns an ID and you either poll a status endpoint or wait for a webhook.

B

Bearer token

Auth

Token sent in Authorization: Bearer <token> header. Whoever holds it can call the API — keep it secret.

Basic auth

Auth

Username and password sent base64-encoded in Authorization: Basic …. Simple, but only safe over HTTPS.

Backoff

Performance

Strategy for retrying failed requests with increasing delay (e.g. 1s, 2s, 4s) to avoid overwhelming a struggling API.

C

CORS

Protocol

Cross-Origin Resource Sharing. Browser security model that requires the API to set an Access-Control-Allow-Origin header for your domain.

cURL

Concept / Tool

Command-line HTTP client. Every API docs page on FreeAPIHub starts with a curl example because it works everywhere.

Cache-Control

Performance

Response header that tells your client how long it can reuse the previous response without asking the API again.

D

Deprecated

Concept / Tool

API endpoint still works but will be removed. Look for a Deprecation header or a 'v1' → 'v2' version note.

Debounce

Performance

Pattern for limiting how often you call an API — e.g. waiting 300ms after the user stops typing before sending a search request.

E

Endpoint

Concept / Tool

A specific URL the API answers on, like /users/123 or /search?q=…. APIs have many endpoints; each does one thing.

ETag

Performance

Server-assigned fingerprint of a response. Send it back with If-None-Match and the API returns 304 if nothing changed — saving bandwidth.

F

Free tier

Concept / Tool

Quota of requests the API gives you without payment. On FreeAPIHub we list the exact number (e.g. "60 req/min, no credit card").

Freemium

Concept / Tool

Free with a paid upgrade path. We tag these distinctly from 'fully free' listings.

G

GraphQL

Protocol

Alternative to REST. One endpoint, you describe exactly which fields you want, server returns just those. Great for mobile clients.

gRPC

Protocol

Binary-format RPC over HTTP/2. Fast for service-to-service; harder to debug than REST. Used by big infra APIs.

H

HTTP methods

Protocol

Verbs: GET (read), POST (create), PUT/PATCH (update), DELETE (remove). REST is built on these.

HTTPS

Protocol

HTTP + TLS encryption. Required for any API handling credentials. We filter listings by HTTPS-only on the directory.

I

Idempotency

Concept / Tool

Property where running the same request twice has the same effect as once. POST is not idempotent by default; pass an Idempotency-Key header.

IP allowlist

Auth

API only accepts requests from listed IP addresses. Common on enterprise free tiers.

J

JSON

Format

JavaScript Object Notation. The default API response format today — strings, numbers, lists, objects. Human-readable.

JWT

Auth

JSON Web Token. A signed, base64-encoded blob containing claims (user ID, expiry). Used as access tokens in modern APIs.

L

Latency

Performance

Time between sending the request and getting the response. Quoted as p50 / p95 / p99 — the median, 95th and 99th percentile.

Long-polling

Concept / Tool

Client opens a request and the server holds it open until something happens. Cheaper than WebSocket; higher latency than webhooks.

M

mTLS

Auth

Mutual TLS. Both client and server authenticate with certificates — no password, no token. Common in banking APIs.

O

OAuth 2.0

Auth

Standard for delegated authorization. Lets a user grant a third-party app limited access to their data without sharing the password.

OpenAPI

Spec

Machine-readable description of an API — its endpoints, params, response shapes. Tools like Swagger UI render docs from it.

P

Pagination

Concept / Tool

Splitting a long list across multiple requests using page/limit params or a next_cursor.

Payload

Concept / Tool

The body of an HTTP request or response. For POST/PUT, this is the JSON you send.

R

Rate limit

Performance

Cap on requests per time window (e.g. 60/min). Exceeding it returns 429. Check the X-RateLimit-Remaining header.

REST

Protocol

Representational State Transfer — most common API style. Uses HTTP verbs (GET, POST, PUT, DELETE) over plain URLs.

Refresh token

Auth

Long-lived credential used only to fetch a new short-lived access token. Stays on your server, never exposed to the browser.

S

SDK

Concept / Tool

Software Development Kit. A language-specific wrapper around the API — handles auth, retries and types so you don't have to.

Status code

Protocol

3-digit HTTP response number. 2xx = success, 3xx = redirect, 4xx = your fault (401 unauth, 404 not found, 429 rate-limited), 5xx = their fault.

SSE

Protocol

Server-Sent Events. One-way stream from server to client over plain HTTP. Used by AI APIs to stream tokens.

T

Throttling

Performance

API slowing or rejecting requests to enforce rate limits. Returns 429 with a Retry-After header.

TLS

Auth

Transport Layer Security — the encryption layer behind HTTPS. Modern APIs require TLS 1.2+.

U

URI / URL

Protocol

The address of an API endpoint. URL is the full thing with scheme; URI is the broader term.

W

Webhook

Protocol

The API calls you when something happens — POSTs JSON to a URL you provide. Cheaper than polling.

WebSocket

Protocol

Bi-directional persistent connection. Use it for live updates, chat or trading data.

Y

YAML

Format

Human-friendly data format. Most OpenAPI specs are written in YAML rather than JSON.