Tagged articles
OpenAPI
84 articles · Page 1 of 1
This article presents a three-layer OpenAPI architecture for AI agent platforms—credential governance, stable primitives, and evolvable management interfaces—emphasizing semantic freezing, platform-issued credentials with request signing, application tiering, and explicit integration authorization to enable third-party systems to integrate reliably without coupling to internal product changes.
AI agentAPI DesignAPI Governance
0 likes · 39 min read

This article defines a 7-layer architecture for self-built Agent platforms, illustrates three real-world misdiagnoses caused by layer confusion, compares four layering approaches, provides a self-check matrix for different product stages, and warns against four common architectural pitfalls.
AI PlatformLayered ArchitectureMCP
0 likes · 29 min read

The article walks through a real‑world agent platform backend, showing how the same OpenAPI contract is split into three distinct faces—OpenAPI for developers, a CLI for AI agents, and a web frontend for humans—detailing the architecture, lifecycle, command tree, and two concrete pitfalls with code examples.
AI agentBackendCLI
0 likes · 18 min read

In the AI era, building a tool starts not with implementation but with audience selection, splitting a single backend into three distinct layers—OpenAPI for integrators, CLI for AI operators, and a frontend product for humans—each with specific design constraints to avoid costly mistakes.
AICLIMCP
0 likes · 14 min read

This article explains how to replace tedious manual conversion of Swagger/OpenAPI specifications into test steps by using Python and AI to automatically generate fully executable pytest test code, covering constraint extraction, intelligent planning, and three practical implementation paths.
AIOpenAPIPython
0 likes · 8 min read

Facing exploding system complexity, unclear global topology, fragmented observability data, and noisy alerts, Jingchen migrated its full‑stack to the cloud and adopted Alibaba Cloud STAROps, a unified CMS 2.0 data base, UModel digital‑twin topology, and OpenAPI‑driven AI diagnostics to turn heavy‑lifting ops work into an automated, business‑focused capability.
Intelligent OperationsOpenAPISRE
0 likes · 10 min read

This article presents a comprehensive production-grade approach to API version management in Spring Boot, covering version identification strategies, custom routing via RequestCondition, DTO isolation with MapStruct, deprecation interceptors with Prometheus metrics, gateway-level traffic splitting using Spring Cloud Gateway and Nginx, and a lifecycle state machine with automated retirement rules.
API versioningMapStructOpenAPI
0 likes · 18 min read

By dissecting a large‑scale banking core‑transaction system upgrade, the article demonstrates how an AI‑driven, three‑layer test‑case generation pipeline—covering intent, contract, and execution—reduces manual effort from five person‑days to three hours, lifts coverage to 82%, and improves boundary‑case success from 31% to 94% while ensuring auditability and continuous feedback.
AI TestingOpenAPITest Automation
0 likes · 9 min read

The open‑source lark‑cli brings over 200 commands across 11 Lark business domains and 19 AI Agent skills, offering a three‑layer architecture, rich output formats, security safeguards, and real‑world use cases that let AI agents programmatically operate your Lark workspace.
AI agentCLILark
0 likes · 10 min read

This article explains why robust Agent Tools are essential for LLM agents, outlines a five‑stage lifecycle with concrete design principles such as type safety, LLM‑friendly interfaces, OpenAPI integration, self‑healing error handling, human‑in‑the‑loop safeguards, and performance optimizations, and demonstrates their impact through retail and fintech case studies.
Agent ToolsIndustry CasesLLM
0 likes · 20 min read

Faced with limitations of existing tools like Quartz, XXL-Job, and PowerJob, the author explains the motivation for creating a custom scheduling framework, describes its architecture—including gRPC communication, protobuf serialization, a self-implemented name server for load balancing, a simple message queue, and time-wheel scheduling—provides code examples, and shares diagrams of discovery and dispatch processes.
JavaMessage QueueOpenAPI
0 likes · 17 min read

The article explains how a test engineering team leveraged OpenAPI contracts and a Python‑driven AI generator to automatically produce comprehensive pytest cases for backend APIs, achieving 5–8× faster development while highlighting practical limits and best‑practice recommendations.
AIBackend testingOpenAPI
0 likes · 8 min read

The article examines common cross‑department collaboration pain points like inconsistent API contracts and fragmented toolchains, then proposes a contract‑first architecture using OpenAPI, schema registries, and automated code generation to standardize APIs, data models, and governance processes.
API ContractOpenAPISchema Registry
0 likes · 9 min read

Learn how to automate API test data creation by leveraging a large language model to parse OpenAPI specifications and generate comprehensive pytest functions covering valid, missing, type‑error, boundary, and format scenarios, with a step‑by‑step Python script that produces ready‑to‑run test files.
AI-generated testsAPI testingOpenAPI
0 likes · 10 min read

This guide shows how to use the Qwen large language model to automatically generate pytest‑style API test scripts from an OpenAPI specification, covering setup, prompt design, model invocation, code extraction, and execution steps.
AI code generationAPI testingOpenAPI
0 likes · 9 min read

This guide explains how to integrate SpringDoc into a Spring Boot project to automatically generate OpenAPI 3 documentation, compares it with Swagger, shows minimal configuration steps, annotation usage, grouping techniques, and necessary adjustments for custom WebMvcConfigurer and Spring Security setups.
API DocumentationOpenAPISpring Boot
0 likes · 14 min read

This guide shows how to integrate springdoc‑openapi 2.7.0 with Spring Boot 3.5.6 to generate an online Swagger UI, covering Maven dependencies, configuration class, annotation usage, response wrapper, version compatibility notes, and the URL to access the generated documentation.
API DocumentationJavaOpenAPI
0 likes · 9 min read

This article explains how the Model Context Protocol (MCP) bridges large language models and external services by converting OpenAPI specifications into callable tools, covering generation with openapi‑generator, mapping rules, three runtime modes (stdio, streamable, SSE), and implementation details in Java, Python, and Go.
AI agentsGoJava
0 likes · 23 min read

This tutorial walks through integrating SpringDoc into a Spring Boot project, covering why it replaces SpringFox, how to configure it with minimal settings, add API annotations, set up grouped documentation, and handle static resources and Spring Security for full Swagger UI access.
API DocumentationJavaOpenAPI
0 likes · 15 min read

This tutorial walks through adding the required Maven dependencies, configuring application.yml, creating SwaggerConfig, implementing sample controllers, accessing the enhanced Knife4j UI and Swagger UI, troubleshooting common issues, and comparing SpringDoc OpenAPI with Knife4j OpenAPI3 to help developers choose the right solution for Spring Boot 3.x projects.
API DocumentationJavaKnife4j
0 likes · 10 min read

This guide walks you through adding the appropriate SpringDoc OpenAPI dependencies for Spring Boot 2.x or 3.x, configuring the library, creating sample controllers with OpenAPI annotations, customizing documentation metadata, and using advanced features like API grouping, hidden endpoints, and offline generation.
API DocumentationOpenAPISpringBoot
0 likes · 6 min read

This article reviews essential tools and formats—such as Postman, Apidog, Swagger/OpenAPI, and API gateways like Amazon API Gateway and Kong—that help backend developers efficiently save, document, and manage HTTP API information throughout the development lifecycle.
API GatewayAPI ManagementOpenAPI
0 likes · 6 min read

This article walks through why SpringDoc replaces SpringFox, shows step‑by‑step minimal configuration, dependency setup, controller annotations, API grouping (both programmatic and declarative), and necessary adjustments for WebMvcConfigurer and Spring Security to generate OpenAPI 3 documentation in a Spring Boot project.
API DocumentationConfigurationJava
0 likes · 15 min read

SpringDoc is a Spring Boot library that automatically generates OpenAPI 3 compliant API documentation, replacing the outdated SpringFox; this guide explains its advantages, minimal configuration steps, grouping techniques, and integration with Swagger UI for seamless API documentation in modern Spring applications.
API DocumentationBackendOpenAPI
0 likes · 15 min read

SpringDoc is a Spring Boot library that automatically generates OpenAPI 3 compliant API documentation, offering seamless integration with Swagger UI; this guide explains its advantages over SpringFox, walks through minimal configuration, grouping strategies, and handling of security and resource handling for robust API documentation.
API DocumentationOpenAPISpring Boot
0 likes · 14 min read

This article introduces Hoppscotch, an open‑source, lightweight API testing tool, outlines its key features, shows how to install and configure it, and provides step‑by‑step usage instructions for importing Swagger APIs and handling authentication tokens.
API testingHoppscotchOpenAPI
0 likes · 5 min read

This article explains why dynamic service discovery is essential, compares static Prometheus configurations with Nacos‑based discovery, and provides step‑by‑step OpenAPI and command‑line examples for registering and deregistering service instances, enabling a fully automated monitoring loop.
Dynamic MonitoringNacosOpenAPI
0 likes · 6 min read

The Model Context Protocol (MCP) is an open‑source interface that standardizes how large language models interact with external data sources and tools, offering a USB‑C‑like universal connector for AI applications, with built‑in session management, security, and flexible HTTP/SSE transport for seamless real‑world integration.
AI IntegrationLLMMCP
0 likes · 7 min read

This article explains the MicroProfile OpenAPI 3.0 specification, covering its architecture, configuration options, core properties, annotation usage, server definitions, programming model, model readers, filters, processing rules, endpoint behavior, and release notes for both 3.0 and earlier versions.
API DocumentationAnnotationsConfiguration
0 likes · 29 min read

This article explains how to standardize and protect OpenAPI interfaces by using globally unique AppId/AppSecret pairs, generating RSA‑based signatures, implementing timestamp and nonce checks, and applying common security measures such as rate limiting, whitelist/blacklist controls, and sensitive data handling, all illustrated with complete Java code examples.
API SecurityAppIdAppSecret
0 likes · 28 min read

Learn how to create fast, modern Python APIs using FastAPI, automatically generate interactive Swagger documentation, and enhance your endpoints with validation, metadata, and a full-featured to‑do list project, all illustrated with clear code examples and step‑by‑step deployment instructions.
FastAPIOpenAPIPython
0 likes · 10 min read

This tutorial walks you through API protocol types, Swagger/OpenAPI documentation setup, advanced configuration, environment‑specific activation, UI enhancement with Knife4j, and practical versioning strategies to efficiently manage and evolve your backend APIs.
API ManagementApifoxKnife4j
0 likes · 10 min read

This article explains how to quickly turn existing HTTP APIs into MCP services using the Go‑based mcp‑gateway, covering the installation of a local Kind Kubernetes cluster, the required YAML manifests, Docker image handling, OpenAPI import, and verification through the web console and chat interface.
GatewayGoKubernetes
0 likes · 14 min read

This guide explains how to transform community STDIO‑based MCP servers into plug‑in‑ready, Server‑Sent Events (SSE) MCP services on Function Compute, covering deployment templates, npx/uvx usage, OpenAPI conversion, security configurations, and debugging steps.
Function ComputeMCPOpenAPI
0 likes · 10 min read

This guide explains how to convert legacy OpenAPI schemas into Model Context Protocol (MCP) configurations, route them through the Higress cloud‑native gateway, set up dual authentication, and finally expose the MCP tools to AI platforms such as Dify, enabling seamless AI‑driven access to both local and internet data sources.
HigressMCPOpenAPI
0 likes · 10 min read

This guide explains how to create a lightweight, extensible Alibaba Cloud OpenAPI MCP Server using only ten lines of Python, covering MCP fundamentals, tool registration via OpenAPI metadata, configuration, code examples, and client setup to enable seamless LLM integration with external services.
Alibaba CloudLLMMCP
0 likes · 9 min read

This article explains how to split a multi‑function OpenAPI interface into independent components using the chain‑of‑responsibility pattern in Spring, detailing the abstract base class, concrete handlers, a shared context, execution order configuration, and a test controller with full code examples.
BackendChain of ResponsibilityDesign Pattern
0 likes · 7 min read

This article explains the agents.json specification, its OpenAPI foundation, how it differs from MCP and Google A2A, and demonstrates how AI agents can load, interpret, and execute multi‑step API flows using code examples and schema illustrations.
AI agentsAPI flowsLLM integration
0 likes · 16 min read

This article explains how Apache Dubbo 3.3.3 natively supports OpenAPI 3, allowing developers to automatically generate API documentation, export Proto files, integrate with Swagger UI and Apifox, and customize the output via annotations, all without extra dependencies or complex configuration.
ApifoxDubboOpenAPI
0 likes · 9 min read

The article highlights how fragmented, undocumented cross‑team communication creates fragile software, then advocates adopting contract‑based design—preconditions, postconditions, invariants—and AI‑assisted tooling to formalize API contracts throughout the development lifecycle, aligning teams, reducing errors, and improving system reliability.
Design by ContractOpenAPIProtobuf
0 likes · 18 min read

This article explains how to set up FastGPT, a Retrieval‑Augmented Generation (RAG) knowledge‑base system powered by large language models, covering both Docker‑compose image deployment and source‑code installation, including environment configuration, database setup, and API usage examples.
AIDockerFastGPT
0 likes · 13 min read

This article explains how to secure OpenAPI interfaces by using globally unique AppId/AppSecret pairs, SHA‑256 and RSA signatures, timestamp and nonce validation, caching, rate‑limiting, parameter validation, and encryption algorithms, providing complete client‑server implementation examples in Java.
API SecurityJavaOpenAPI
0 likes · 26 min read

This guide explains how to install, configure, and leverage the Grafana Alibaba Cloud OpenAPI plugin to visualize cloud resources, create alerts, and accelerate prototype validation in fast‑paced development environments.
Alibaba CloudGrafanaOpenAPI
0 likes · 9 min read

This article compares Google’s Protocol Buffers and the Swagger/OpenAPI framework, detailing their features, data formats, use cases, flexibility, development workflows, and why Google created protobuf, helping developers choose the right tool for high‑performance data serialization or comprehensive API documentation.
API DesignOpenAPIProtocol Buffers
0 likes · 7 min read


21CTOMay 6, 2024 · Backend Development
Microsoft’s newly released TypeSpec language offers a lightweight, open‑source, API‑centric approach that lets developers describe APIs with minimal types, compile to OpenAPI, JSON Schema, and Protobuf, and leverage modern tooling for faster, more reusable code.
API DesignOpenAPITypeSpec
0 likes · 5 min read

This article introduces TypeSpec, a lightweight, extensible language for describing REST, OpenAPI, gRPC and other APIs, outlines its key features, demonstrates how to generate OpenAPI, JSON Schema and Protobuf files, and provides step‑by‑step instructions for installing the compiler, setting up the VS Code extension, creating a project, and compiling a sample service.
API DesignOpenAPIProtobuf
0 likes · 5 min read

This guide explains why upgrading from Spring Boot 2.x to 3.x is essential, outlines the required JDK 17 migration, Spring Boot version bump, configuration property changes, Jakarta EE transition, and updates to Spring Security, Kafka, RestTemplate, and OpenAPI integration, providing code examples for each step.
Jakarta EEJava 17Kafka
0 likes · 10 min read

This article explains the concept of open APIs and signature verification, outlines the end‑to‑end signing and verification flow, and provides complete Spring Boot code—including configuration properties, a signature manager, custom annotation, AOP aspect, request‑caching filter, and utility class—to securely validate third‑party requests without exposing credentials.
BackendSecurityOpenAPIRequestCaching
0 likes · 20 min read

This article explains the concept of open interfaces and signature verification, outlines the end‑to‑end signing and verification flow, and provides a complete Spring Boot implementation including configuration properties, a signature manager, custom annotation, AOP aspect, request‑caching filter and utility classes, all illustrated with code snippets.
API SecurityJavaOpenAPI
0 likes · 20 min read

This article explains how the OpenAPI specification standardizes interfaces and improves security by using AppId/AppSecret pairs, RSA‑based signatures, timestamp and nonce mechanisms, parameter validation, rate limiting, and encryption best practices, accompanied by complete Java code examples.
API SecurityAuthenticationJava
0 likes · 27 min read

This article explains how to use OpenAPI standards to standardize interfaces, generate unique AppId/AppSecret pairs, create RSA‑based signatures, and implement practical security measures such as timestamps, nonces, rate limiting, and data validation, all illustrated with full Java code examples.
API SecurityAuthenticationJava
0 likes · 29 min read

This article explains how to use OpenAPI standards to secure API interfaces by introducing AppId/AppSecret mechanisms, RSA‑based signatures, timestamp and nonce anti‑replay measures, and provides complete Java code examples for client‑side signing and server‑side verification along with common protection techniques such as rate limiting and data validation.
AppIdAppSecretJava
0 likes · 28 min read

This article explores the various Python frameworks and tools—Django, Django REST Framework, Flask, Requests, Swagger/OpenAPI, Marshmallow, Pydantic, Starlette, and Uvicorn—that inspired FastAPI, highlighting the features each contributed such as automatic documentation, micro‑framework flexibility, type‑hinted validation, and high‑performance async support.
APIFastAPIOpenAPI
0 likes · 10 min read

This article explains why TypeScript is suitable for business front‑end code, demonstrates practical usage with React, SWR, and OpenAPI, and shows how to generate type definitions automatically using openapi‑typescript to improve robustness and maintainability.
OpenAPISWRTypeScript
0 likes · 6 min read

This article explains why TypeScript is well‑suited for business‑level front‑end development, demonstrates practical usage with React hooks, SWR, and OpenAPI‑driven code generation, and shows how to keep type safety and reduce runtime errors while integrating backend APIs.
OpenAPISWRTypeScript
0 likes · 7 min read

This article explains the three main use cases of API gateways—Open API platforms, microservice gateways, and API service management platforms—describes their position in enterprise architecture, outlines practical deployment scenarios, compares competing solutions, and provides criteria for choosing the right gateway for performance, scalability, extensibility, and cloud deployment.
OpenAPIcloud-nativeenterprise architecture
0 likes · 11 min read

DataTester’s Open Platform provides a configurable, extensible A/B testing solution that integrates via OpenAPI, SDKs, and a visual integration console, enabling enterprises to customize experiments, reduce development costs, and streamline deployment while supporting diverse business needs through modular components and a material ecosystem.
A/B testingDataTesterOpenAPI
0 likes · 12 min read

This article explains Bilibili’s unified API management platform, covering service launch processes, manual versus automated metadata collection, code‑first API definitions in Go and Java, version control, collaboration features, mock testing, and micro‑service standardization to improve development efficiency and reduce operational costs.
API ManagementMock testingOpenAPI
0 likes · 19 min read

Bilibili’s unified API management platform automates documentation generation for Go and Java services, ties each API version to specific code commits, supports version snapshots, integrates with gateways for debugging and OpenAPI export, and provides service‑level mocking, thereby standardizing microservice development and reducing cross‑team overhead.
API ManagementMockingOpenAPI
0 likes · 20 min read

This article introduces the open‑source SQLE platform, explains its intelligent SQL scanning features and OpenAPI, and provides a step‑by‑step guide with code examples for creating scan tasks, sending requests, and building a Go‑based utility to automatically upload and audit SQL files.
GoOpenAPISQL audit
0 likes · 9 min read

This guide explains how Alibaba Cloud EventBridge’s open API target enables event‑driven automation for managing cloud resources, covering event bus types, official event sources, required parameters, and step‑by‑step examples such as creating RocketMQ topics and ECS snapshots.
Alibaba CloudCloud AutomationOpenAPI
0 likes · 13 min read

The article explains the origins, specifications, features, and ecosystem support of OData, JSON API, GraphQL, and OpenAPI, helping developers decide whether switching between these API standards offers real benefits for their projects.
GraphQLJSON:APIOData
0 likes · 8 min read

This article explains how to engineer APIs by automating protobuf file management, code generation, CI/CD pipelines, error handling, validation, and documentation generation using tools such as GitLab, Kratos, Apifox, and quicktype, ultimately improving development efficiency across backend and client teams.
API engineeringApifoxCI/CD
0 likes · 20 min read

After SpringFox became outdated and incompatible with Spring Boot 2.6, this article introduces SpringDoc as a modern OpenAPI 3‑based alternative, explains its advantages, shows how to integrate it, migrate annotations, configure security, and provides sample code and screenshots for a seamless transition.
OpenAPISpring BootSpringDoc
0 likes · 12 min read

This guide explains how to use Apache JMeter for native and distributed load testing, configure and execute tests on Alibaba Cloud PTS via the console, OpenAPI, or the PTS‑JMeter plugin, and how to monitor, analyze, and export detailed performance reports.
Alibaba CloudDistributed TestingOpenAPI
0 likes · 15 min read

Page‑Peggy, Meituan Medicine Technology’s cross‑platform rich‑text management platform, lets product and operation teams instantly create and publish FAQ‑style pages through a visual editor while offering developers a WebIDE for custom code, template markets, SDK integration and Open API, resulting in over 5,000 pages, 82 million views and adoption across dozens of departments.
Frontend DevelopmentOpenAPIWebIDE
0 likes · 19 min read

This comprehensive guide explains why clear API specifications are essential, compares RESTful and RPC styles, outlines OpenAPI and Google design principles, and provides practical rules for versioning, URL design, HTTP methods, status codes, authentication, rate limiting, error handling, naming conventions, and documentation to help developers build robust, maintainable services.
HTTP MethodsOpenAPIRESTful
0 likes · 25 min read

This article explores the roles of API gateways—including Open API platforms, microservice gateways, and service management—examines their placement within enterprise architectures, compares open‑source and cloud solutions, and provides criteria for selecting the most suitable gateway based on performance, scalability, openness, and deployment model.
API GatewayCloud SolutionsOpenAPI
0 likes · 12 min read

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.
API DesignBackend IntegrationData Consistency
0 likes · 14 min read


21CTOMay 15, 2021 · Backend Development
This article explores the multiple roles of API gateways—from OpenAPI platforms and microservice gateways to enterprise service management—examining architectural placement, practical usage scenarios, competitive solutions, and key criteria for selecting the right gateway in both private and public cloud environments.
OpenAPIenterprise architecture
0 likes · 11 min read

This article explains how to integrate Swagger using Springfox 3.0.0 into a Spring Boot project, covering required dependencies, configuration files, annotations, new features, compatibility requirements, and provides a complete example with code snippets for generating interactive OpenAPI documentation.
API DocumentationOpenAPISpring Boot
0 likes · 11 min read

API gateways serve as unified entry points for Open API platforms, microservice architectures, and internal applications, enabling access control, traffic management, and service governance; the article examines their roles, deployment scenarios, competitive alternatives, and criteria for selecting suitable open‑source, cloud, or self‑built solutions.
API GatewayOpenAPIcloud-native
0 likes · 11 min read

The OpenAPI Specification 3.1.0 has been released, introducing a top‑level jsonSchemaDialect field, updated JSON Schema support, refined URI handling, enhanced file‑upload descriptions, and numerous clarifications that modernize API description and improve consistency across implementations.
3.1.0API SpecificationJSON Schema
0 likes · 4 min read

This guide explains how to integrate Dubbo‑Api‑Docs into a Dubbo project, providing Swagger‑style interface documentation and testing via Dubbo‑Admin, covering annotation setup, Maven dependencies, example projects, and deployment steps.
API DocumentationDubboDubbo-Admin
0 likes · 14 min read

This article provides a comprehensive guide on using Swagger for REST API documentation in Spring Boot projects, covering Swagger fundamentals, Springfox introduction, the features of Springfox 3.0.0, compatibility requirements, Maven integration, configuration classes, common annotations, and a complete example with code snippets.
API DocumentationJavaOpenAPI
0 likes · 11 min read

This article walks through the complete process of integrating Swagger 3.0 into a Spring Boot 2.3.5 application, covering dependency setup, the role of springfox‑boot‑starter, custom OpenAPI configuration, API grouping, security schemes, and global request parameters with concrete code examples.
API DocumentationConfigurationJava
0 likes · 11 min read

The article explains how Alibaba Cloud’s new DSL, Darabonba, redefines OpenAPI metadata to generate multi‑language SDKs, modular interface designs, automatic code‑sample creation, and test case generation, addressing common OpenAPI usability issues such as missing SDKs, inconsistent styles, and lack of runnable examples.
Code SamplesDSLDarabonba
0 likes · 13 min read

This article introduces SpringFox 3.0.0, highlights its new features such as Spring 5 WebFlux support, OpenAPI 3 compatibility, and zero‑configuration starter, then provides a step‑by‑step guide with Maven dependencies, annotations, controller examples, and notes on updated Swagger UI endpoints.
API DocumentationBackendJava
0 likes · 7 min read

TeaDSL, a domain‑specific language created by Alibaba Cloud’s Open Platform SDK team, tackles the pain points of OpenAPI integration by providing a unified intermediate representation that supports diverse gateway styles and automatically generates multi‑language SDKs, code samples, and test cases, dramatically reducing development effort.
API GatewayDomain-Specific LanguageOpenAPI
0 likes · 14 min read

This guide explains how to integrate springdoc-openapi with Spring Boot to automatically generate OpenAPI 3 documentation, customize paths, combine with Swagger UI, use Maven plugins, support WebFlux, apply JSR‑303 bean validation, and document error responses via @ControllerAdvice, providing complete code snippets and configuration examples.
JavaMavenOpenAPI
0 likes · 9 min read

This article examines why robust API specifications are crucial for cloud services, outlines seven major challenges—from choosing design patterns and resource modeling to error handling, versioning, and ecosystem integration—and offers practical guidance for building consistent, reliable OpenAPI interfaces at scale.
API DesignOpenAPIRESTful
0 likes · 20 min read

This article walks through diagnosing intermittent OpenAPI latency by using Alibaba's open‑source TProfiler Java agent to collect method‑level timing without modifying code, covering setup, command‑line usage, log analysis, and practical performance‑improvement recommendations.
BackendJava AgentOpenAPI
0 likes · 8 min read

This article walks through a real‑world performance problem where an OpenAPI service sometimes responds in milliseconds and other times takes seconds, explains why adding logging is impractical, and demonstrates how to use Alibaba's TProfiler Java agent to profile the call chain, collect method timings, and analyze the results without modifying any source code.
APMJavaOpenAPI
0 likes · 10 min read

This article walks through diagnosing intermittent OpenAPI latency by reproducing the issue, visualizing the request flow, using Alibaba's TProfiler agent without code changes, configuring and running profiling commands, analyzing the generated logs, and summarizing actionable performance improvements.
BackendJavaOpenAPI
0 likes · 8 min read
