BestHub
Sign in
Tagged articles
295 articles
Page 2 of 3
Architect's Guide
Architect's Guide
Sep 2, 2023 · Backend Development

Designing an API Layer and BFF Architecture for a Large‑Scale Supply Chain System

This article examines the challenges of a complex supply‑chain system built on Spring Cloud, proposes introducing an API layer to handle aggregation, distributed calls and decoration, and further adopts a Backend‑for‑Frontend (BFF) approach to reduce service coupling, improve client‑specific optimization, and streamline team responsibilities.

BFFBackend DevelopmentService Architecture
0 likes · 15 min read
Designing an API Layer and BFF Architecture for a Large‑Scale Supply Chain System
Architects Research Society
Architects Research Society
Jul 22, 2023 · Backend Development

Understanding JSON API: Benefits, Features, and a FitBit Case Study

This article explains what JSON API is, outlines its key advantages such as compound documents, sparse fieldsets, optional features, pagination and caching, compares it with GraphQL, and illustrates its practical use through a FitBit case study, helping readers decide if it fits their API design needs.

BackendHTTPJSON API
0 likes · 12 min read
Understanding JSON API: Benefits, Features, and a FitBit Case Study
macrozheng
macrozheng
Jun 20, 2023 · Backend Development

Mastering E‑Commerce Product Module Design with the Mall Project

This article walks through the Mall project's product module—covering its architecture, feature design, database schema, and API implementation—while providing links to source code, video tutorials, and a mind‑map that together serve as a comprehensive guide for building robust e‑commerce systems.

Backend DevelopmentSpringBootapi-design
0 likes · 10 min read
Mastering E‑Commerce Product Module Design with the Mall Project
Top Architect
Top Architect
May 30, 2023 · Backend Development

Designing API Error Codes and Messages: Best Practices and Standardization

This article explains how to design clear, consistent API error codes and messages by referencing HTTP status code segmentation, defining code‑message pairs, customizing user‑friendly messages, and centralizing handling to improve communication, debugging, and monitoring for backend services.

BackendError CodesHTTP status
0 likes · 6 min read
Designing API Error Codes and Messages: Best Practices and Standardization
21CTO
21CTO
May 22, 2023 · Backend Development

How to Build Stable, Composable Enterprise APIs: A Practical Design Guide

This guide outlines practical steps and best‑practice recommendations for designing reusable, stable, and composable enterprise APIs, covering domain‑driven modeling, stakeholder collaboration, API specification creation, validation, tooling, and governance to ensure high‑quality, evolvable services.

API governanceDomain ModelingEnterprise API
0 likes · 12 min read
How to Build Stable, Composable Enterprise APIs: A Practical Design Guide
MaGe Linux Operations
MaGe Linux Operations
May 14, 2023 · Backend Development

Designing Clear API Return Codes: From HTTP Status to Custom Messages

This article explains how to design consistent API return codes by leveraging HTTP status conventions, defining structured error codes with messages, personalizing user‑facing messages, and using unified handling for monitoring and alerting, ultimately reducing communication and maintenance costs.

Backend DevelopmentError HandlingHTTP status
0 likes · 5 min read
Designing Clear API Return Codes: From HTTP Status to Custom Messages
Architect
Architect
May 3, 2023 · Backend Development

Comprehensive Guide to Backend API Design with Spring Boot: Validation, Global Exception Handling, Unified Responses, Versioning, and Security

This article provides a step‑by‑step tutorial on building robust Spring Boot backend APIs, covering environment setup, parameter validation techniques, global exception handling, unified response structures, API version control, and security measures such as token authentication, timestamp checks, URL signing, replay protection, and HTTPS.

Exception HandlingParameter ValidationSpring Boot
0 likes · 27 min read
Comprehensive Guide to Backend API Design with Spring Boot: Validation, Global Exception Handling, Unified Responses, Versioning, and Security
Sohu Tech Products
Sohu Tech Products
Apr 26, 2023 · Backend Development

Designing Robust and Idempotent APIs: Principles and Practices

This article explores essential API design principles—idempotency, robustness, and security—by discussing practical techniques such as request locks, database unique constraints, Redis distributed locks, token‑based authentication, JWT, and defensive coding practices to ensure reliable, safe, and maintainable backend services.

BackendIdempotencyRobustness
0 likes · 36 min read
Designing Robust and Idempotent APIs: Principles and Practices
Alipay Experience Technology
Alipay Experience Technology
Mar 23, 2023 · Frontend Development

What’s New in G2 5.0? A Deep Dive into the Next‑Gen Frontend Visualization Library

G2 5.0, the latest open‑source visualization library from AntV, introduces a progressive visual grammar, richer chart types, enhanced data analysis, animation, annotation, color expressiveness, modular architecture, server‑side rendering, and a new Spec API, while outlining future work and upgrade guidance for developers.

Frontend LibraryServer-side Renderingapi-design
0 likes · 12 min read
What’s New in G2 5.0? A Deep Dive into the Next‑Gen Frontend Visualization Library
DataFunSummit
DataFunSummit
Mar 20, 2023 · Fundamentals

Practical Naming Guidelines for Code: Principles, Rules, and Vocabulary

This article provides practical, experience‑based naming guidelines for software development, covering precision, readability, abbreviation policies, language‑specific conventions, design‑pattern naming, and a comprehensive code‑term glossary to help developers choose clear and maintainable identifiers.

Software Engineeringapi-designbest practices
0 likes · 40 min read
Practical Naming Guidelines for Code: Principles, Rules, and Vocabulary
MaGe Linux Operations
MaGe Linux Operations
Feb 13, 2023 · Backend Development

Why GraphQL Is the Modern Solution to REST’s API Challenges

The article explains how REST, despite its 20‑year popularity and simplicity, suffers from redundancy, coarse granularity and maintenance overhead, and shows how GraphQL’s declarative, schema‑driven approach, single endpoint and flexible data fetching address these problems while offering a versatile integration architecture and rich ecosystem.

Backend DevelopmentData FetchingGraphQL
0 likes · 16 min read
Why GraphQL Is the Modern Solution to REST’s API Challenges
Efficient Ops
Efficient Ops
Feb 8, 2023 · Backend Development

Mastering RESTful API Design: Best Practices and APISIX Implementation

This article explains what RESTful APIs are, outlines their architectural constraints, shares practical design guidelines such as using nouns in URIs, proper HTTP methods, status codes, versioning strategies, and demonstrates how Apache APISIX can enforce these practices and modernize legacy APIs without changing existing code.

APISIXHTTP methodsRESTful API
0 likes · 12 min read
Mastering RESTful API Design: Best Practices and APISIX Implementation
Java High-Performance Architecture
Java High-Performance Architecture
Jan 24, 2023 · Backend Development

How to Build Highly Available Backend APIs: 10 Essential Design Principles

This article explains why high availability is crucial for backend services and outlines ten practical design principles—including dependency control, avoiding single points, load balancing, isolation, rate limiting, circuit breaking, async processing, degradation, gray release, and chaos engineering—to help developers create resilient APIs.

Backendapi-designfault tolerance
0 likes · 10 min read
How to Build Highly Available Backend APIs: 10 Essential Design Principles
Architects Research Society
Architects Research Society
Jan 13, 2023 · Backend Development

Backend for Frontend (BFF) Pattern: Designing Single‑Purpose Edge Services for User Interfaces

The article explains how the Backend for Frontend (BFF) pattern creates dedicated, lightweight server‑side APIs for each UI type—desktop web, mobile, or third‑party—allowing teams to tailor functionality, reduce coupling, aggregate micro‑service calls, and improve autonomy while addressing performance, scaling, and organizational concerns.

BFFBackendapi-design
0 likes · 20 min read
Backend for Frontend (BFF) Pattern: Designing Single‑Purpose Edge Services for User Interfaces
macrozheng
macrozheng
Dec 12, 2022 · Backend Development

Designing Secure, Reliable APIs: Signatures, Encryption, Rate Limiting & More

Learn how to design robust, secure API interfaces by implementing signatures, encryption, IP whitelists, rate limiting, parameter validation, unified responses, exception handling, logging, idempotency, request size limits, load testing, asynchronous processing, data masking, and comprehensive documentation to ensure stability and safety.

DocumentationIdempotencySecurity
0 likes · 15 min read
Designing Secure, Reliable APIs: Signatures, Encryption, Rate Limiting & More
Su San Talks Tech
Su San Talks Tech
Dec 12, 2022 · Backend Development

Designing Secure and Robust APIs: Signatures, Encryption, Rate Limiting, and More

This article outlines essential practices for building secure, reliable API interfaces—including request signing, data encryption, IP whitelisting, rate limiting, parameter validation, unified responses, exception handling, logging, idempotency, payload limits, performance testing, asynchronous processing, data masking, and comprehensive documentation—to help developers meet safety, stability, and maintainability requirements.

IdempotencySecurityapi-design
0 likes · 15 min read
Designing Secure and Robust APIs: Signatures, Encryption, Rate Limiting, and More
Code Ape Tech Column
Code Ape Tech Column
Nov 23, 2022 · Backend Development

Best Practices for Consistent Backend API Design

This guide presents a concise set of best‑practice rules for designing consistent, resource‑oriented RESTful APIs, covering naming conventions, URL structures, HTTP methods, versioning, pagination, security, monitoring, and documentation to improve developer experience and system reliability.

BackendHTTP methodsURL conventions
0 likes · 9 min read
Best Practices for Consistent Backend API Design
Top Architect
Top Architect
Nov 19, 2022 · Backend Development

Design and Implementation of an Open API Token Authentication System with Spring Boot

This article explains how to design an open API authentication mechanism by creating app credentials, storing them in a MySQL table, generating short‑lived access tokens with a utility class, exposing a token endpoint, and securing all /openApi/* routes with a Spring interceptor, complete with code examples.

JavaSpring Bootapi-design
0 likes · 9 min read
Design and Implementation of an Open API Token Authentication System with Spring Boot
DataFunSummit
DataFunSummit
Nov 16, 2022 · Artificial Intelligence

Designing Effective APIs for AI Open‑Source Software

This article explains why API design is crucial for AI open‑source projects, outlines the new challenges faced, presents three fundamental design principles with concrete examples, and offers practical guidance on documentation, error handling, and evaluation to create user‑friendly, scalable AI software ecosystems.

AI softwareDocumentationError Handling
0 likes · 11 min read
Designing Effective APIs for AI Open‑Source Software
Top Architect
Top Architect
Oct 28, 2022 · Backend Development

Guidelines for Front‑End/Back‑End Separation and API Specification

The article explains why front‑end and back‑end should be separated, outlines the challenges of integration, describes the responsibilities and development process for a clean API contract, and provides detailed request/response specifications with code examples for building a maintainable SPA architecture.

BackendSPAapi-design
0 likes · 11 min read
Guidelines for Front‑End/Back‑End Separation and API Specification
Rare Earth Juejin Tech Community
Rare Earth Juejin Tech Community
Oct 20, 2022 · Backend Development

Designing a Unified Base Package for Backend Projects: Maven Dependencies, Standardized Response Body, and Data Object Segmentation

This article explains how to construct a reusable base package for backend systems by defining Maven dependency guidelines, a unified response body with business codes, proper data object layers such as PO, BO, DTO, VO, and pagination utilities, while illustrating the concepts with concrete Java code examples.

DDDJavaResponse Structure
0 likes · 11 min read
Designing a Unified Base Package for Backend Projects: Maven Dependencies, Standardized Response Body, and Data Object Segmentation
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.

BackendVersioningapi-design
0 likes · 7 min read
Best Practices for Designing a Good API
21CTO
21CTO
Sep 27, 2022 · Backend Development

Mastering API Design: From Basics to Rate Limiting, Versioning, and Security

This article shares practical insights on API design, covering fundamentals, rate limiting, version management, security considerations, and inter‑team integration, illustrated with code snippets and diagrams to help developers build clear, standardized, and robust backend interfaces.

SecurityVersioningapi-design
0 likes · 17 min read
Mastering API Design: From Basics to Rate Limiting, Versioning, and Security
ITFLY8 Architecture Home
ITFLY8 Architecture Home
Sep 25, 2022 · Backend Development

Master System Design Discussions: From Requirements to Scalable Architecture

This guide walks you through structuring a system‑design discussion—from clarifying functional and non‑functional requirements, mapping user flows and API calls, to outlining high‑level architecture, scaling strategies, and drafting a database schema—using a Twitter‑like example to illustrate each step.

ScalabilitySystem Designapi-design
0 likes · 9 min read
Master System Design Discussions: From Requirements to Scalable Architecture
Top Architect
Top Architect
Sep 24, 2022 · Frontend Development

Guidelines for Frontend‑Backend Separation and API Specification

This article explains why and how to separate frontend and backend responsibilities, outlines the evolution from MVC to SPA architectures, and provides detailed API request and response conventions—including JSON formats, pagination, and special field handling—to improve collaboration and reduce integration effort.

BackendSPAapi-design
0 likes · 10 min read
Guidelines for Frontend‑Backend Separation and API Specification
政采云技术
政采云技术
Sep 6, 2022 · Frontend Development

Front‑End and Back‑End Collaboration Guidelines and Best Practices

This article presents a comprehensive set of front‑end and back‑end collaboration standards, covering why specifications are needed, the recommended workflow, detailed API conventions, common pitfalls with concrete solutions, and the measurable benefits of adopting a unified development protocol.

CollaborationSoftware Engineeringapi-design
0 likes · 13 min read
Front‑End and Back‑End Collaboration Guidelines and Best Practices
IT Architects Alliance
IT Architects Alliance
Aug 15, 2022 · R&D Management

Essential Practices for Effective Engineering Projects and R&D Management

This article outlines comprehensive guidelines for keeping customers happy, managing projects, designing robust APIs, conducting thorough code reviews, shaping strategic direction, ensuring observability, and fostering research, all aimed at building resilient and high‑performing engineering teams.

Code reviewObservabilityProject Management
0 likes · 12 min read
Essential Practices for Effective Engineering Projects and R&D Management
IT Architects Alliance
IT Architects Alliance
Aug 9, 2022 · Backend Development

Mastering Consistent API Design: 22 Essential Best Practices

This guide presents 22 practical rules for designing clean, consistent RESTful APIs—including resource-oriented URLs, kebab‑case paths, camelCase parameters, proper use of HTTP verbs, versioning, pagination, field selection, CORS, security, and monitoring—to help developers avoid common pitfalls and improve API usability.

HTTP methodsSecurityURL conventions
0 likes · 9 min read
Mastering Consistent API Design: 22 Essential Best Practices
Top Architect
Top Architect
Aug 8, 2022 · Backend Development

Best Practices for Designing Consistent Backend APIs

This article presents a concise yet comprehensive guide to RESTful API design, covering resource-oriented naming, kebab‑case URLs, camelCase parameters, proper use of HTTP verbs, versioning, health/metrics endpoints, pagination, field selection, authentication headers, CORS, error handling, and golden rules for creating clean, maintainable backend services.

HTTPMicroservicesapi-design
0 likes · 9 min read
Best Practices for Designing Consistent Backend APIs
Java Backend Technology
Java Backend Technology
Jul 22, 2022 · Backend Development

Why Unified API Responses Matter: Mastering Spring Boot Controllers and AOP

This article explains common pitfalls in Java API design—such as inconsistent return formats, missing error handling, and inappropriate parameters—and demonstrates how a unified ResultBean, strict controller conventions, and AOP logging can dramatically improve code readability, maintainability, and error management in Spring Boot projects.

JavaResultBeanSpring Boot
0 likes · 10 min read
Why Unified API Responses Matter: Mastering Spring Boot Controllers and AOP
ITPUB
ITPUB
Jul 17, 2022 · Backend Development

36 Essential Tips for Designing Robust Backend APIs

This comprehensive guide presents 36 practical recommendations for backend engineers, covering parameter validation, compatibility, extensibility, idempotency, error handling, logging, performance optimization, caching, rate limiting, security, transaction management, and clear communication to help design reliable, maintainable, and scalable service interfaces.

BackendScalabilitySecurity
0 likes · 27 min read
36 Essential Tips for Designing Robust Backend APIs
Top Architect
Top Architect
Jun 22, 2022 · Backend Development

Designing API Error Codes and Messages: Best Practices

This article explains how to design clear and consistent API error codes and messages by borrowing the segmentation logic of HTTP status codes, defining code‑message pairs, providing personalized user‑facing messages, and centralizing handling for monitoring and alerting, ultimately reducing communication and maintenance costs.

Error CodesHTTP statusapi-design
0 likes · 6 min read
Designing API Error Codes and Messages: Best Practices
macrozheng
macrozheng
Jun 21, 2022 · Backend Development

Why Enums Can Break RPC Calls and How to Avoid Them

An online service threw an IllegalArgumentException because a downstream system added a new enum constant without notifying dependent services, leading to deserialization failures in RPC calls; the article explains the root cause, JSON serialization behavior, and recommends using strings instead of enums for API parameters and return values.

JavaRPCapi-design
0 likes · 10 min read
Why Enums Can Break RPC Calls and How to Avoid Them
Bilibili Tech
Bilibili Tech
Jun 3, 2022 · Backend Development

Bilibili Open Platform Video Submission Workflow and Upload Token Design

Bilibili’s Open Platform streamlines video uploads by replacing a complex multi‑parameter flow with a single upload_token that encapsulates authentication and file metadata, enabling chunked uploads, merging, and manuscript submission via a JavaScript SDK, which cuts integration errors and speeds first‑time submissions by over sixty percent.

Backend DevelopmentBilibiliJS SDK
0 likes · 12 min read
Bilibili Open Platform Video Submission Workflow and Upload Token Design
Top Architect
Top Architect
May 26, 2022 · Backend Development

Designing API Return Codes and Messages: Best Practices for Backend Services

This article explains how to design clear, consistent API return codes and messages by referencing HTTP status codes, defining code‑message pairs, supporting personalized messages for different clients, and using unified handling for monitoring and alerting, ultimately improving communication and maintenance costs.

Error CodesHTTP status codesSoftware Architecture
0 likes · 6 min read
Designing API Return Codes and Messages: Best Practices for Backend Services
BaiPing Technology
BaiPing Technology
May 16, 2022 · Backend Development

Master API Resource Naming: Best Practices for Consistent Backend Design

This article explains Google’s API design guidelines for resource naming, covering uniqueness, URI path formatting, collection identifiers, ID constraints, full and relative names, and how to annotate fields in protobuf messages for clear, consistent backend APIs.

Backend DevelopmentGoogle AIPapi-design
0 likes · 14 min read
Master API Resource Naming: Best Practices for Consistent Backend Design
Architecture Digest
Architecture Digest
Apr 19, 2022 · Backend Development

Best Practices for Designing HTTP APIs: Status Codes, JSON Payloads, Resource Naming, and Error Handling

This guide outlines comprehensive backend API design recommendations, covering appropriate HTTP status codes, JSON request bodies, unique resource identifiers, timestamp formats, consistent URL structures, nested relationships, error message schemas, caching, pagination, versioning, security, and clear documentation with executable examples.

BackendHTTPStatus Codes
0 likes · 13 min read
Best Practices for Designing HTTP APIs: Status Codes, JSON Payloads, Resource Naming, and Error Handling
IT Architects Alliance
IT Architects Alliance
Mar 24, 2022 · Backend Development

Understanding REST and Best Practices for RESTful API Design

This article explains the origins of REST, breaks down its core concepts of resources, representations, and state transfer, and provides comprehensive guidelines for designing clean, secure, and versioned RESTful APIs, including URL conventions, HTTP verbs, status codes, and authentication practices.

CRUDHTTPURI
0 likes · 8 min read
Understanding REST and Best Practices for RESTful API Design
Top Architect
Top Architect
Mar 24, 2022 · Backend Development

Understanding REST and Best Practices for RESTful API Design

This article explains the origins of REST, breaks down its core concepts of resources, representations, and state transfer, and provides comprehensive guidelines for designing clean, versioned, and secure RESTful APIs, including URL conventions, HTTP verbs, status codes, and authentication.

HTTPURL conventionsWeb services
0 likes · 9 min read
Understanding REST and Best Practices for RESTful API Design
MaGe Linux Operations
MaGe Linux Operations
Mar 12, 2022 · Backend Development

Mastering RESTful API Design in Go: 12 Essential Best Practices

This article revisits RESTful API design using Go Web, covering twelve practical guidelines such as JSON usage, verb‑free and pluralized paths, hierarchical resources, pagination, unified response formats, proper HTTP status codes, versioning, HTTPS, and documentation to help developers build clear, consistent, and secure APIs.

BackendGinJSON
0 likes · 9 min read
Mastering RESTful API Design in Go: 12 Essential Best Practices
Selected Java Interview Questions
Selected Java Interview Questions
Mar 6, 2022 · Backend Development

22 Best Practices for Designing Consistent and Secure RESTful APIs

This article presents 22 practical best‑practice guidelines for designing consistent, secure, and user‑friendly RESTful APIs, covering URL naming conventions, HTTP methods, versioning, pagination, JSON naming, monitoring endpoints, CORS, error handling, and other essential considerations for backend developers.

BackendHTTPURL conventions
0 likes · 10 min read
22 Best Practices for Designing Consistent and Secure RESTful APIs
Code Ape Tech Column
Code Ape Tech Column
Feb 28, 2022 · Backend Development

Best Practices for Consistent Backend API Design

This article presents a concise set of best‑practice guidelines for designing consistent, resource‑oriented RESTful APIs, covering naming conventions, URL structures, HTTP methods, parameter handling, versioning, monitoring, security, error handling, and documentation tools.

BackendHTTP methodsURL conventions
0 likes · 11 min read
Best Practices for Consistent Backend API Design
Java Interview Crash Guide
Java Interview Crash Guide
Feb 23, 2022 · Backend Development

Designing Clear API Return Codes: Lessons from HTTP Status Codes

This article explains why consistent API return‑code design matters, illustrates how HTTP status code segmentation can inspire better error codes, and shows how to pair codes with customizable messages for both developers and end‑users to improve communication and maintenance efficiency.

Error HandlingHTTP status codesapi-design
0 likes · 4 min read
Designing Clear API Return Codes: Lessons from HTTP Status Codes
Java Interview Crash Guide
Java Interview Crash Guide
Feb 22, 2022 · Backend Development

Ensuring API Idempotency: Prevent Duplicate Requests in Scalable Systems

Idempotency ensures that repeated API calls produce the same result, preventing duplicate processing in high‑traffic systems; this article explains why it matters, typical duplicate request scenarios, and a practical implementation using client‑generated identifiers to cache and filter repeated submissions.

IdempotencyMicroservicesSoftware Architecture
0 likes · 4 min read
Ensuring API Idempotency: Prevent Duplicate Requests in Scalable Systems
21CTO
21CTO
Feb 17, 2022 · Backend Development

10 Essential API Design Rules for Consistent Backend Services

This guide presents a concise set of best‑practice rules for designing consistent, RESTful backend APIs—including naming conventions, URL structures, HTTP methods, versioning, pagination, security, and documentation tools—to help developers create clear, maintainable, and user‑friendly services.

BackendHTTP methodsSecurity
0 likes · 9 min read
10 Essential API Design Rules for Consistent Backend Services
Top Architect
Top Architect
Feb 15, 2022 · Backend Development

Best Practices for Designing Consistent Backend APIs

This article presents a comprehensive set of best‑practice guidelines for designing clean, consistent, and secure RESTful backend APIs, covering URL naming conventions, parameter styles, resource naming, versioning, pagination, authentication, error handling, and documentation tools.

HTTPURL conventionsVersioning
0 likes · 10 min read
Best Practices for Designing Consistent Backend APIs
DataFunTalk
DataFunTalk
Feb 9, 2022 · Artificial Intelligence

Designing Effective APIs for AI Open‑Source Software

This article explains why API design is crucial for AI open-source software, outlines new challenges, presents basic design principles, and offers practical guidelines, examples, and best practices to create user-friendly, stable, and extensible interfaces that lower learning costs and foster ecosystem growth.

AISoftware EngineeringUser experience
0 likes · 10 min read
Designing Effective APIs for AI Open‑Source Software
IT Architects Alliance
IT Architects Alliance
Feb 7, 2022 · Backend Development

Best Practices for Consistent Backend API Design

This guide presents a concise set of best‑practice rules for designing consistent, RESTful backend APIs—including naming conventions, versioning, pagination, security, monitoring, and error handling—to improve developer experience and maintainability across microservice architectures.

HTTP methodsSecurityURL conventions
0 likes · 10 min read
Best Practices for Consistent Backend API Design
Architect
Architect
Feb 5, 2022 · Backend Development

Best Practices for Designing Consistent RESTful APIs

This article presents a concise, step‑by‑step guide to designing clean, consistent RESTful APIs, covering resource naming, URL conventions, HTTP methods, versioning, pagination, field selection, security, monitoring, error handling, and documentation tools, with concrete code examples for each rule.

HTTP methodsURL conventionsVersioning
0 likes · 10 min read
Best Practices for Designing Consistent RESTful APIs
Architecture Digest
Architecture Digest
Jan 27, 2022 · Backend Development

Designing API Error Codes and Result Codes: Best Practices

This article explains why a well‑designed API error‑code system—using consistent numeric or string codes, clear messages, HTTP‑status‑like segmentation, personalized user messages, and unified handling for monitoring—reduces communication overhead, simplifies maintenance, and improves overall backend reliability.

Error CodesHTTP statusapi-design
0 likes · 6 min read
Designing API Error Codes and Result Codes: Best Practices
Architect
Architect
Jan 23, 2022 · Backend Development

Designing Consistent API Return Codes: Lessons from HTTP Status Codes

The article explains why a well‑designed API return‑code system—modeled after HTTP status codes, with clear numeric ranges, descriptive messages, and personalized user messages—reduces communication overhead, simplifies maintenance, and enables effective monitoring and alerting for backend services.

Backend DevelopmentError CodesHTTP status codes
0 likes · 6 min read
Designing Consistent API Return Codes: Lessons from HTTP Status Codes
21CTO
21CTO
Jan 10, 2022 · Backend Development

Mastering REST vs RESTful: Key Differences, Best Practices, and Future Trends

This comprehensive guide explains the origins and definitions of REST and RESTful, outlines core architectural constraints, compares terminology, presents best‑practice API design patterns—including URI conventions, HTTP methods, error handling, filtering, pagination, versioning, and health checks—while evaluating the future role of REST versus GraphQL.

HTTPVersioningapi-design
0 likes · 30 min read
Mastering REST vs RESTful: Key Differences, Best Practices, and Future Trends
Top Architect
Top Architect
Dec 28, 2021 · Backend Development

Using @PathVariable for RESTful API Parameters in Spring MVC

This article explains how to use the @PathVariable annotation in Spring MVC to handle required and optional parameters in RESTful URLs, illustrates the syntax with image-based examples, discusses the complexity of multiple parameters, and advises using POST for more intricate cases, while also offering promotional links and giveaways.

JavaPathVariableRESTful
0 likes · 4 min read
Using @PathVariable for RESTful API Parameters in Spring MVC
21CTO
21CTO
Dec 26, 2021 · Backend Development

REST vs gRPC: Which API Architecture Wins for Modern Microservices?

This article explains what APIs are, introduces RPC and gRPC, compares them with REST across protocols, data formats, performance, code generation, and browser support, and offers guidance on when to choose gRPC or REST for microservice and mobile applications.

HTTP/2MicroservicesProtocol Buffers
0 likes · 11 min read
REST vs gRPC: Which API Architecture Wins for Modern Microservices?
IT Architects Alliance
IT Architects Alliance
Oct 14, 2021 · Backend Development

Best Practices for Designing Robust APIs

This article explains why APIs are essential, how to model data and resources, apply RESTful principles, choose clear naming conventions, manage versioning, and implement pagination, providing practical guidelines and code examples for building maintainable and developer‑friendly backend services.

Versioningapi-designpagination
0 likes · 8 min read
Best Practices for Designing Robust APIs
Programmer DD
Programmer DD
Oct 8, 2021 · Frontend Development

Why Front‑End/Back‑End Separation Matters: Practical API Guidelines for Modern Web Apps

This article explains the evolution from MVC to SPA, highlights the pain points of tightly coupled front‑end and back‑end development, and provides concrete responsibility separation, development processes, and a detailed API specification to enable efficient, loosely‑coupled collaboration in modern web projects.

BackendSPAapi-design
0 likes · 14 min read
Why Front‑End/Back‑End Separation Matters: Practical API Guidelines for Modern Web Apps
Architecture Digest
Architecture Digest
Oct 7, 2021 · Backend Development

Designing Open Platform APIs: Application Registration, OAuth2 Authorization, Request Parameters, and Signature Verification

This article outlines a practical approach to designing open‑platform APIs, covering service‑provider application registration, usability, security, OAuth2‑based authorization, systematic and business request parameters, signature generation, verification, and best‑practice code examples.

BackendOAuth2Open Platform
0 likes · 9 min read
Designing Open Platform APIs: Application Registration, OAuth2 Authorization, Request Parameters, and Signature Verification
Top Architect
Top Architect
Sep 27, 2021 · Backend Development

Best Practices for Designing, Securing and Scaling Java Backend APIs

This article explains how to design robust Java backend APIs, covering interface definition, request/response formats, error handling, token generation, digital signing, interceptor chains, rate limiting, HTTPS migration, and strategies for high concurrency and high availability such as load balancing, clustering and caching.

Backend DevelopmentJavaSpring Boot
0 likes · 16 min read
Best Practices for Designing, Securing and Scaling Java Backend APIs
IT Architects Alliance
IT Architects Alliance
Jul 11, 2021 · Backend Development

10 Best Practices for Designing a Robust Microservices Architecture

This article explains how adopting ten essential microservice best practices—such as single responsibility, independent data stores, asynchronous communication, circuit breakers, API gateways, backward‑compatible APIs, versioning, dedicated infrastructure, independent release pipelines, and organizational efficiency—helps build a loosely‑coupled, scalable, and maintainable backend system.

BackendDistributed SystemsMicroservices
0 likes · 9 min read
10 Best Practices for Designing a Robust Microservices Architecture
Top Architect
Top Architect
Jun 24, 2021 · Backend Development

Designing Idempotent APIs and Global Unique ID Strategies

This article explains the concept of API idempotency, why it is needed, practical design approaches, and how to generate globally unique identifiers using methods such as UUID and Snowflake to ensure reliable, high‑performance backend services.

BackendIdempotencyapi-design
0 likes · 8 min read
Designing Idempotent APIs and Global Unique ID Strategies
Code Ape Tech Column
Code Ape Tech Column
Jun 15, 2021 · Backend Development

How to Build Robust, High‑Concurrency APIs: Design, Security, and Scaling Tips

This article outlines practical guidelines for designing and implementing enterprise‑grade APIs, covering request/response definitions, unified error handling, interceptor chains, token‑based authentication, rate limiting, load balancing, clustering, caching, and strategies for achieving high concurrency and high availability.

Exception Handlingapi-designhigh concurrency
0 likes · 18 min read
How to Build Robust, High‑Concurrency APIs: Design, Security, and Scaling Tips
Su San Talks Tech
Su San Talks Tech
Jun 7, 2021 · Backend Development

Why Region IDs Break OpenAPI Integrations and How to Design Resilient Solutions

This article examines the challenges of synchronizing enterprise data across systems when region identifiers differ, explores several technical approaches—including persisting local tables, name‑based and code‑based lookups, snapshot storage, manual updates, and flexible API fields—and concludes with a pragmatic, business‑centric solution for reliable integration.

Backend IntegrationData ConsistencyOpenAPI
0 likes · 14 min read
Why Region IDs Break OpenAPI Integrations and How to Design Resilient Solutions
IT Architects Alliance
IT Architects Alliance
Jun 6, 2021 · Backend Development

Understanding the Richardson Maturity Model and Best Practices for REST API Design

This article explains the Richardson Maturity Model for REST, illustrates each level with a hospital appointment example—including HTTP request/response code snippets and HATEOAS links—and then outlines practical REST API design guidelines such as using nouns, proper HTTP verbs, pagination, versioning, and comprehensive status‑code handling.

HTTPMaturity Modelapi-design
0 likes · 15 min read
Understanding the Richardson Maturity Model and Best Practices for REST API Design
21CTO
21CTO
Mar 19, 2021 · Backend Development

Why GraphQL Beats REST for Modern APIs: Benefits and Code Examples

This article compares REST and GraphQL, highlighting REST's issues like excessive round‑trips, over‑/under‑fetching, and rigidity, and shows how GraphQL solves them with single‑request queries and flexible data selection, while offering guidance on when to choose each approach.

Backend DevelopmentCode ExamplesGraphQL
0 likes · 6 min read
Why GraphQL Beats REST for Modern APIs: Benefits and Code Examples
Alibaba Cloud Developer
Alibaba Cloud Developer
Mar 19, 2021 · Fundamentals

What Core Design Principles Drive Reliable Financial Software?

This article outlines practical software design principles—layered architecture, single responsibility, data redundancy, security, concurrency, and API design—derived from real‑world financial platform projects, showing how concrete rules help avoid coupling, data loss, and performance pitfalls.

Backend Developmentapi-designarchitecture principles
0 likes · 12 min read
What Core Design Principles Drive Reliable Financial Software?
Programmer DD
Programmer DD
Feb 27, 2021 · Backend Development

Why Generic API Error Messages Hurt Users and How to Handle Exceptions Properly

The article critiques returning vague third‑party API error messages, explains why swallowing exceptions and omitting stack traces make debugging hard, and advises providing user‑friendly messages and proper logging to improve reliability and maintainability of backend services.

Error Handlingapi-designexception logging
0 likes · 3 min read
Why Generic API Error Messages Hurt Users and How to Handle Exceptions Properly
21CTO
21CTO
Feb 17, 2021 · Backend Development

Mastering API Design for Microservices: Principles, Pitfalls, and Best Practices

Effective API design is crucial for microservice architectures, reducing communication overhead, preventing API decay, and ensuring scalability; this article outlines common pitfalls, core design principles such as simplicity, focus, extensibility, compatibility, thorough testing, and documentation to help developers build robust, maintainable services.

Backend DevelopmentMicroservicesSoftware Architecture
0 likes · 11 min read
Mastering API Design for Microservices: Principles, Pitfalls, and Best Practices
JavaScript
JavaScript
Jan 27, 2021 · Backend Development

Which API Response Format Is Best: Include Empty B or Omit It?

The discussion compares two API response designs—always returning an empty array for field B versus omitting B when it has no data—and evaluates which approach provides clearer contracts and easier handling for front‑end developers.

Backendapi-designfrontend
0 likes · 1 min read
Which API Response Format Is Best: Include Empty B or Omit It?
21CTO
21CTO
Jan 24, 2021 · Backend Development

Why GraphQL Is Replacing REST: A Deep Dive into Modern API Design

This article examines the limitations of traditional REST APIs, explains how GraphQL offers a more flexible, efficient, and declarative approach to data fetching, outlines its core concepts, schema design, type system, and deployment architectures, and provides guidance on integrating GraphQL into existing backend and frontend ecosystems.

GraphQLapi-designrest
0 likes · 17 min read
Why GraphQL Is Replacing REST: A Deep Dive into Modern API Design