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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
