openapi▌

Category: test \n OpenAPI 产品发现Minimal Viable Test \n Prerequisites \n \n AK/SK is configured. \n GoalsSkill: skills/platform/openapi/alicloud-platform-openapi-product-api-discovery/ 。 \n \n Test Steps \n \n 运行一个产品源抓取脚本。 \n 运行合并脚本。 \n 限制 OPENAPI_META_MAX_PRODUCTS=1 执行元数据抓取。 \n \n Expected Results \n \n output/product-scan/ 下产生最小结果文件。 \n

Automated OpenAPI 3.0 documentation generation for Spring Boot 3.x REST APIs with Swagger UI. \n \n Integrates SpringDoc to auto-generate OpenAPI specs from annotated controllers, models, and validation rules without manual configuration \n Supports JWT Bearer, OAuth2, and Basic Auth security documentation with global scheme configuration and per-endpoint security requirements \n Includes comprehensive annotation patterns for documenting endpoints, request/response bodies, parameters, error resp

ASP.NET Minimal API endpoints with automatic OpenAPI/Swagger documentation and strong typing. \n \n Organize endpoints using MapGroup() , endpoint filters, and feature-based folder structures for scalability \n Define explicit request/response DTOs with validation attributes; use record types and TypedResults for type safety \n Leverage .NET 9 built-in OpenAPI support with operation summaries, descriptions, operationIds, and property-level documentation via [Description()] \n Apply document and

$22

Follow this workflow to collect products, resolve API metadata, and build summaries for skill planning.

Complete reference for writing, validating, and interpreting OpenAPI Specification 2.0 (Swagger) documents. \n \n Covers all core schema elements: Swagger Object root, Info/Contact/License metadata, Paths, Operations, Parameters (path, query, header, body, formData), Responses, and Schemas with composition and polymorphism support \n Includes security definitions for Basic auth, API Key, and OAuth2 flows (implicit, password, application, accessCode) with scope and requirement objects \n Provides

Agent-oriented reference for the OpenAPI Specification 3.2.0. Use when editing, generating, or validating OpenAPI descriptions (OAD).

Generate, maintain, and validate OpenAPI 3.1 specifications for RESTful APIs. \n \n Supports design-first, code-first, and hybrid approaches with templates for complete specs, FastAPI/Python generation, and TypeScript/Express decorators \n Includes reusable components for schemas, parameters, responses, and security schemes to minimize duplication across endpoints \n Provides Spectral and Redocly validation rules to enforce naming conventions, security requirements, and documentation standards \

Converts OpenAPI 3.0 specifications to TypeScript interfaces and type guards.

Generate complete, production-ready applications directly from OpenAPI specifications. \n \n Accepts OpenAPI specs via URL, local file, or direct content input; validates completeness and identifies endpoints, schemas, authentication requirements, and data relationships \n Generates full project structure with controllers, services, models, repositories, and configuration files following framework conventions and best practices \n Includes unit tests, README with setup instructions, environment