JavaEdge
JavaEdge
Aug 18, 2024 · Backend Development

When Should You Use Fine‑Grained vs Coarse‑Grained Resources in REST APIs?

This article explains how to choose between fine‑grained and coarse‑grained resource designs in REST APIs, illustrating trade‑offs with blog‑post examples, showing how to model business processes as intent resources, and discussing the impact of avoiding PUT in favor of CQRS.

CQRSCRUDapi-design
0 likes · 23 min read
When Should You Use Fine‑Grained vs Coarse‑Grained Resources in REST APIs?
Architecture Digest
Architecture Digest
Sep 30, 2022 · Backend Development

Best Practices for Designing a Good API

This article explains why well‑designed APIs are essential, covering data modeling, resource hierarchy, naming conventions, RESTful principles, CRUD operations, versioning strategies, and pagination techniques, and provides concrete examples and guidelines to help developers create robust, maintainable, and developer‑friendly APIs.

Paginationapi-designbackend
0 likes · 7 min read
Best Practices for Designing a Good API
21CTO
21CTO
Dec 31, 2018 · Backend Development

Designing Robust APIs: Principles, Practices, and Real-World Examples

This article explores core API design principles—clear mental models, simplicity, multiple implementations—and offers concrete best‑practice guidance, from documentation and resource modeling to idempotency, compatibility, batch updates, and error handling, illustrated with the classic POSIX File API.

Compatibilityapi-designidempotency
0 likes · 21 min read
Designing Robust APIs: Principles, Practices, and Real-World Examples