Api_design terms
Contracts between systems that need to trust each other
A well-designed API is a pleasure to integrate; a poorly designed one is a tax on every team that touches it. This category covers REST principles, GraphQL, versioning strategies, authentication patterns, rate limiting, idempotency, error responses, and the design decisions that make APIs intuitive, stable, and a joy to build against.
🤖 AI Guestbook — API Design educational data only
|
|
Last 30 days
Agents 2
No pings yesterday
Amazonbot 180Perplexity 138Google 52Ahrefs 38Unknown AI 34ChatGPT 28SEMrush 8Meta AI 3Qwen 2Backlinks.com 1
Most referenced — API Design
No pings yesterday
How they use it
crawler 459
crawler_json 21
pre-tracking 4
Category total484 pings
Terms pinged18 / 18
Distinct agents9
API Versioning
Strategies for evolving an API without breaking existing consumers — URI versioning, header versioning, and content negotiation.
1mo ago
api_design intermediate
HTTP Content Negotiation
The HTTP mechanism by which clients declare what formats, languages, and encodings they accept (Accept, Accept-Language, Accept-Encoding) and servers respond with the best match — or 406 Not Acceptable if none fits.
1mo ago
api_design intermediate
GraphQL Subscriptions A GraphQL operation type that opens a long-lived connection to the server and pushes real-time data updates to the client whenever a specific event occurs.
1mo ago
api_design advanced
API Authentication Patterns
Bearer tokens (JWT) for user sessions, API keys for machine-to-machine, mTLS for highest-security internal services — matching authentication method to the use case.
2mo ago
api_design intermediate
API Backwards Compatibility Rules for evolving an API without breaking existing clients — additive changes are safe, removals and renames require versioning, and deprecation needs a documented sunset period.
2mo ago
api_design intermediate
API Contract Testing
Consumer-driven contract tests verify that a provider API matches what consumers expect — catching breaking changes before deployment, without end-to-end tests.
2mo ago
api_design advanced
API Documentation
OpenAPI/Swagger for REST APIs, Postman collections for explorability, and Stoplight for design-first workflows — good API docs are the product's user interface for developers.
2mo ago
api_design intermediate
API Idempotency Keys PHP 7.0+ A client-generated unique key sent with non-idempotent requests — the server stores the response and returns it unchanged if the same key is received again, preventing duplicate operations.
2mo ago
api_design intermediate
API Mocking
Prism (OpenAPI mock server), WireMock (HTTP stub server), Mockoon (GUI), and Guzzle MockHandler for PHP unit tests — enabling testing without real API calls.
2mo ago
api_design intermediate
GraphQL vs REST vs gRPC
REST for public APIs and resource-oriented design, GraphQL for flexible client-driven queries, gRPC for high-performance internal service communication.
2mo ago
api_design intermediate
Hypermedia APIs — HATEOAS
REST APIs that include links in responses — clients discover available actions from the response rather than hardcoding URLs, making APIs self-describing and evolvable.
2mo ago
api_design advanced
Webhook Design PHP 5.0+
Best practices for reliable webhooks — HMAC signature verification, idempotency, delivery retry with exponential backoff, and handling slow consumers with queues.
2mo ago
api_design intermediate
API Deprecation The process of signalling that an API version, endpoint, or parameter will be removed — giving consumers time to migrate while maintaining backwards compatibility.
2mo ago
api_design intermediate
API Error Handling Returning structured, machine-readable error responses using appropriate HTTP status codes — enabling clients to handle errors programmatically without parsing message strings.
2mo ago
api_design intermediate
API Pagination Patterns Strategies for returning large collections in manageable chunks — offset/page-based, cursor/keyset, and hybrid approaches each suit different use cases.
2mo ago
api_design intermediate
API Rate Limiting Controlling how many requests a client can make in a time window — protecting against abuse, ensuring fair usage, and preventing accidental DoS from misbehaving clients.
2mo ago
api_design intermediate
GraphQL Schema Design PHP 7.0+
Designing GraphQL schemas that are intuitive, evolvable, and performant — with clear type hierarchies, nullable conventions, and avoiding the N+1 query problem.
2mo ago
api_design advanced
REST Architectural Constraints PHP 5.0+
The six constraints Fielding defined for REST — statelessness, uniform interface, client-server separation, cacheability, layered system, and optional code on demand.
2mo ago
api_design intermediate