Articles tagged “api-design”
30 articles
gRPC vs REST vs GraphQL APIs 2026
gRPC, REST, and GraphQL compared on performance, streaming, and tooling in 2026. Pick the right API protocol for microservices, mobile, and public APIs.
REST vs GraphQL vs gRPC APIs 2026
REST vs GraphQL vs gRPC in 2026: latency, payload size, and tooling compared across 3 real-world scenarios. gRPC wins on internal APIs by 4x. Full matrix.
Motia API Workflows: Steps & Events 2026
Motia unifies REST, events, and cron into one Step primitive. How to design event-driven API workflows in 2026 with TypeScript and Python code examples.
Motia: Event-Driven API Workflows in 2026
Motia's event-driven Steps replace REST controllers, queue workers, and cron jobs. API design patterns, code examples, and comparison with Express and NestJS.
Arazzo 1.0: Multi-Step API Workflows Spec 2026
Arazzo 1.0 lets you describe multi-step API workflows in machine-readable YAML. Practical guide with examples, tools, and how it makes your APIs AI-agent ready.
Building TypeScript API Client SDKs in 2026
Build a high-quality TypeScript API SDK in 2026 — auto-generation vs handwritten, pagination, retry logic, typed errors, streaming, and versioning strategy.
AI Is Transforming API Design and Documentation 2026
AI is transforming API design and documentation in 2026 — generated docs, automated SDK generation, intelligent testing, and emerging AI-native patterns.
API Breaking Changes Without Breaking Clients 2026
Evolve your API without breaking integrations: deprecation timelines, Stripe's version pinning model, Sunset headers, and migration communication patterns.
API Error Handling: Status Codes & Error Objects 2026
A practical guide to API error handling in 2026 — HTTP status codes, error response formats, client-side retry logic, and patterns from Stripe, GitHub, Twilio.
API-First Development: Why It Matters More Than 2026
Why API-first development is the default approach in 2026 — design-first workflows, contract testing, parallel development, and how to implement it now.
API-First vs Code-First Development 2026
API-first vs code-first in 2026: OpenAPI, tRPC, and FastAPI compared. When design-first pays off and when TypeScript type inference beats a formal spec.
API Idempotency: Why It Matters in 2026
Implement API idempotency to prevent duplicate payments and charges. The idempotency key pattern, storage implementation, Stripe's model, and common gotchas.
API Pagination: Cursor vs Offset in 2026
Compare API pagination patterns — cursor, offset, and keyset. Performance benchmarks, consistency guarantees, implementation code, and when to use each in 2026.
API Rate Limiting Best Practices for 2026
Compare rate limiting algorithms — token bucket, sliding window, leaky bucket — with Redis implementation, standard headers, and real-world examples in 2026.
API Security Checklist Before Launch 2026
20-item API security checklist: authentication, BOLA prevention, input validation, rate limiting, data protection, and the OWASP API Security Top 10 for 2026.
API Versioning Strategies 2026
Compare API versioning approaches — URL path, header, query parameter, and content negotiation — with real-world examples from Stripe, GitHub, and Twilio.
The Best API Documentation Sites 2026
A breakdown of the best API documentation in 2026 — what Stripe, Anthropic, Cloudflare, and others do right, and the patterns you should steal for 2026.
Best API Documentation Tools 2026
Best API documentation tools in 2026: Mintlify, Readme, and Stoplight compared on pricing, git-native workflows, OpenAPI support, and developer experience.
Building Webhooks That Don't Break in 2026
Build reliable webhooks: HMAC signing, retry queues, idempotent consumers, and delivery guarantees. Best practices from Stripe, GitHub, and Svix for 2026.
Content Negotiation in REST APIs 2026
How content negotiation works in REST APIs — Accept headers, media types, versioning via content type, and practical implementation patterns for 2026.
REST vs tRPC vs GraphQL vs gRPC: API Patterns 2026
Is REST dying? How tRPC, GraphQL, gRPC, and type-safe patterns are changing API design in 2026 — when REST still wins and when newer patterns make more sense.
Designing APIs for Mobile Apps in 2026
Design APIs for mobile apps: reduce round trips, minimize payloads, handle unreliable connections, and implement offline-first sync patterns for 2026.
GraphQL vs REST: When to Use Each in 2026
Compare GraphQL and REST: performance, type safety, caching, complexity, and real-world tradeoffs. When to use GraphQL, REST, or both in the same product.
gRPC vs Connect-RPC vs tRPC 2026
gRPC uses Protobuf over HTTP/2 for cross-language high-performance RPC. Connect-RPC bridges gRPC to browser-compatible HTTP with JSON support. tRPC provides.
HATEOAS in 2026: Is Hypermedia API Design Dead?
An honest assessment of HATEOAS and hypermedia-driven APIs. Why most APIs ignore it, when it actually helps, and practical alternatives for API discoverability.
How to Build an API SDK That Developers Actually 2026
Build API SDKs developers actually adopt: auth ergonomics, error types, auto-pagination, retry logic, code generation, and documentation patterns for 2026.
How to Build a Public API Developers Want 2026
Build a public API developers adopt: fast onboarding, great docs, fair pricing, and the DX patterns that Stripe, Twilio, and Resend use to win developers.
How to Design REST APIs Developers Love 2026
Design REST APIs developers love: URL conventions, HTTP method usage, status codes, error formatting, pagination, and versioning patterns from top API teams.
Developer-First APIs: What Makes Them Different 2026
What separates developer-first APIs from enterprise-first ones — DX patterns, documentation, pricing, SDKs, and why developers are choosing them here.
API Rate Limiting Best Practices 2026
Handle API rate limits like a pro in 2026. Retry strategies, caching, backoff algorithms, and how to implement rate limiting on your own API correctly.