Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"availability": "unknown",
"callability": "documentation_only",
"category": "development",
"data_handling": {
"location": "local",
"notes": "The documented operation runs on the chosen local executor. This is an architectural inference, not a packet-capture privacy audit. No hosted processing service is required by this invocation; package acquisition, plugins, test code and configured remotes may use the network. Keep sensitive inputs and output logs local. Telemetry and dependency behavior were not exhaustively audited. \u6240\u5217\u672C\u5730\u5904\u7406\u65B9\u5F0F\u662F\u8C03\u7528\u67B6\u6784\u63CF\u8FF0\uFF0C\u4E0D\u662F\u7F51\u7EDC/\u63D2\u4EF6/\u4F9D\u8D56\u7684\u9690\u79C1\u5BA1\u8BA1\uFF0C\u4E5F\u4E0D\u8BC1\u660E\u672C\u673A\u5DF2\u5B89\u88C5\u3002"
},
"description": "\u516C\u5F00\u8D44\u6599\u6574\u7406\uFF0C\u672A\u8BA4\u9886\uFF0C\u4E0D\u4EE3\u8868\u63D0\u4F9B\u8005\u6388\u6743\u6216\u72EC\u7ACB\u8BA4\u8BC1\u3002\u7528\u9014\uFF1AGenerate API client SDKs or server stubs from an OpenAPI definition\u3002\u8BB8\u53EF\uFF1A\u6838\u5FC3 Apache-2.0\uFF1B\u751F\u6210\u8F93\u51FA\u3001\u6A21\u677F\u53CA\u4F9D\u8D56\u8BB8\u53EF\u987B\u5206\u522B\u5BA1\u67E5\u3002\u3002\u5730\u57DF\u4E0E\u4F9B\u5E94\uFF1A{\u0022status\u0022: \u0022No geographic allowlist established\u0022, \u0022notes\u0022: \u0022Local execution is not a claim of worldwide download/service availability. Check operating-system support, export requirements and any remote dependency for the actual deployment region.\u0022}",
"inputs": [
"Reviewed OpenAPI v2/v3 definition",
"Generator choice/options/templates"
],
"invocation": {
"authentication": {
"kind": "none",
"notes": "\u6240\u5217\u672C\u5730\u6838\u5FC3\u6A21\u5F0F\u65E0\u9700\u5382\u5546\u8D26\u53F7\uFF1B\u4E0B\u8F7D\u5B89\u88C5\u3001\u8FDC\u7A0B\u76EE\u6807\u3001\u63D2\u4EF6\u548C\u5176\u4ED6\u670D\u52A1\u7684\u8D26\u6237/\u8BBF\u95EE\u6388\u6743\u53E6\u884C\u6838\u5BF9\u3002"
},
"command": "openapi-generator-cli generate -i api.yaml -g typescript-fetch -o generated-client",
"entry_url": null,
"kind": "local_cli",
"method": null,
"request_example": null,
"requirements": [
"OpenAPI Generator CLI/JAR",
"Java runtime for JAR execution",
"Target language build dependencies",
"\u5F53\u524D\u7A33\u5B9A JAR \u6587\u6863\u8981\u6C42\u81F3\u5C11 Java 11\uFF1B\u83B7\u51C6\u7684\u8F93\u51FA\u8DEF\u5F84\u53CA\u7ECF\u5BA1\u67E5\u7684 spec/templates/options\u3002",
"\u672C\u8F6E\u4EC5\u6838\u5BF9\u6587\u6863\uFF0C\u672A\u5B89\u88C5\u3001\u6267\u884C\u6B64\u80FD\u529B\u6216\u5EFA\u7ACB\u53EF\u7528\u8D26\u53F7\u3002"
]
},
"limitations": [
"\u5F53\u524D\u7A33\u5B9A JAR \u6587\u6863\u8981\u6C42\u81F3\u5C11 Java 11\uFF0C\u8FD8\u9700\u76EE\u6807\u8BED\u8A00\u6784\u5EFA\u4F9D\u8D56\u548C\u83B7\u51C6\u8F93\u51FA\u76EE\u5F55\u3002",
"\u4E0D\u53EF\u4FE1\u89C4\u8303\u3001\u6A21\u677F\u3001\u9009\u9879\u548C\u73AF\u5883\u53D8\u91CF\u53EF\u80FD\u5BFC\u81F4\u6CE8\u5165\uFF1B\u672C\u5730\u751F\u6210\u8F6F\u4EF6\u4E0D\u662F\u5DF2\u8FD0\u884C\u7684\u6258\u7BA1 API\u3002",
"\u8BB8\u53EF\u8FB9\u754C\uFF1A\u6838\u5FC3 Apache-2.0\uFF1B\u751F\u6210\u8F93\u51FA\u3001\u6A21\u677F\u53CA\u4F9D\u8D56\u8BB8\u53EF\u987B\u5206\u522B\u5BA1\u67E5\u3002",
"\u5730\u57DF\u8FB9\u754C\uFF1A{\u0022status\u0022: \u0022No geographic allowlist established\u0022, \u0022notes\u0022: \u0022Local execution is not a claim of worldwide download/service availability. Check operating-system support, export requirements and any remote dependency for the actual deployment region.\u0022}"
],
"outputs": [
"Generated source code",
"Configuration/docs depending on generator"
],
"pricing": {
"model": "open_source_self_hosted",
"notes": "\u6240\u5217\u672C\u5730\u5F00\u6E90\u8F6F\u4EF6\u4E0D\u662F\u514D\u8D39\u6258\u7BA1\u670D\u52A1\uFF1B\u81EA\u884C\u627F\u62C5\u5B89\u88C5\u3001\u8BA1\u7B97\u3001\u5B58\u50A8\u3001\u4E0B\u8F7D\u53CA\u76EE\u6807\u670D\u52A1\u53EF\u80FD\u7684\u8D39\u7528\u3002\u8F6F\u4EF6\u53CA\u9644\u5E26\u7EC4\u4EF6\u6309\u8BB8\u53EF\u4F7F\u7528\uFF1B\u672C\u8F6E\u672A\u5B9E\u9645\u5B89\u88C5\u6216\u8D2D\u4E70\u3002 \u8F6F\u4EF6/\u7D20\u6750/\u670D\u52A1\u8BB8\u53EF\u6761\u4EF6\u5206\u522B\u9002\u7528\u3002",
"source_url": "https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/LICENSE"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [
"Bootstrap a typed service client",
"Create a consistent API integration skeleton"
],
"sources": [
{
"basis": "official_documentation",
"checked_at": "2026-10-20T11:07:14.745259\u002B00:00",
"title": "OpenAPI Generator / OpenAPITools / official source 1",
"url": "https://openapi-generator.tech/docs/usage/"
},
{
"basis": "official_repository",
"checked_at": "2026-10-20T11:07:15.146871\u002B00:00",
"title": "OpenAPI Generator / OpenAPITools / official source 2",
"url": "https://github.com/OpenAPITools/openapi-generator"
},
{
"basis": "official_repository",
"checked_at": "2026-10-20T11:07:14.663260\u002B00:00",
"title": "OpenAPI Generator / OpenAPITools / official source 3",
"url": "https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/LICENSE"
}
],
"summary": "\u6839\u636E\u7ECF\u5BA1\u67E5\u7684\u63A5\u53E3\u89C4\u8303\u548C\u914D\u7F6E\u5728\u83B7\u51C6\u76EE\u5F55\u751F\u6210\u5BA2\u6237\u7AEF\u4EE3\u7801\uFF1B\u751F\u6210\u4EE3\u7801\u4ECD\u9700\u7F16\u8BD1\u3001\u6D4B\u8BD5\u53CA\u9274\u6743\u548C\u9519\u8BEF\u5904\u7406\u590D\u6838\u3002",
"tags": [
"OpenAPI Generator / OpenAPITools",
"\u5B98\u65B9\u6587\u6863\u7EA7",
"\u672A\u8BA4\u9886"
],
"terms_url": "https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/LICENSE",
"title": "OpenAPI Generator \u00B7 \u4ECE\u63A5\u53E3\u89C4\u8303\u751F\u6210\u5BA2\u6237\u7AEF",
"unknowns": [
"\u76EE\u6807\u8BBE\u5907\u5DF2\u5B89\u88C5\u7248\u672C\u3001\u5B9E\u9645\u529F\u80FD\u7ED3\u679C\u3001\u7AEF\u5230\u7AEF\u4EFB\u52A1\u53CA\u751F\u4EA7\u53EF\u9760\u6027\u5747\u672A\u9A8C\u8BC1\u3002",
"\u5730\u533A\u53EF\u8FBE\u6027\u3001\u5177\u4F53\u914D\u989D/\u6027\u80FD\u53CA\u5B8C\u6574\u9690\u79C1\u884C\u4E3A\u672A\u9A8C\u8BC1\uFF1B\u65E0\u8FD0\u884C\u6216\u5408\u4F5C\u6210\u529F\u58F0\u660E\u3002",
"\u5177\u4F53\u76EE\u6807\u673A\u64CD\u4F5C\u7CFB\u7EDF\u3001\u6784\u5EFA/\u4F9D\u8D56\u548C\u539F\u7D20\u6750\u6743\u5229\u3002"
],
"verification": {
"checked_at": "2026-10-20T11:07:15.146871\u002B00:00",
"checks_performed": [
"\u8BFB\u53D6\u5E76\u9759\u6001\u6838\u5BF9\u6240\u5217\u5B98\u65B9\u8D44\u6599\uFF0C\u4FDD\u7559\u6BCF\u4E2A\u6765\u6E90\u7684\u672C\u6B21\u5E26\u65F6\u533A\u65F6\u95F4\u548C\u5185\u5BB9\u5B9A\u4F4D\u3002",
"\u533A\u5206\u8C03\u7528\u7C7B\u578B\u3001\u8BA4\u8BC1/\u5B89\u88C5\u6761\u4EF6\u3001\u8BB8\u53EF/\u8D39\u7528\u3001\u5730\u57DF\u53CA\u6570\u636E\u8FB9\u754C\uFF1B\u8BB0\u5F55\u5931\u8D25\u6765\u6E90\uFF0C\u672A\u5C06\u5176\u7B97\u4F5C\u6210\u529F\u3002"
],
"evidence_urls": [
"https://openapi-generator.tech/docs/usage/",
"https://github.com/OpenAPITools/openapi-generator",
"https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/LICENSE"
],
"level": "documentation_only",
"not_verified": [
"\u76EE\u6807\u8BBE\u5907\u5DF2\u5B89\u88C5\u7248\u672C\u3001\u5B9E\u9645\u529F\u80FD\u7ED3\u679C\u3001\u7AEF\u5230\u7AEF\u4EFB\u52A1\u53CA\u751F\u4EA7\u53EF\u9760\u6027\u5747\u672A\u9A8C\u8BC1\u3002",
"\u5730\u533A\u53EF\u8FBE\u6027\u3001\u5177\u4F53\u914D\u989D/\u6027\u80FD\u53CA\u5B8C\u6574\u9690\u79C1\u884C\u4E3A\u672A\u9A8C\u8BC1\uFF1B\u65E0\u8FD0\u884C\u6216\u5408\u4F5C\u6210\u529F\u58F0\u660E\u3002",
"\u5177\u4F53\u76EE\u6807\u673A\u64CD\u4F5C\u7CFB\u7EDF\u3001\u6784\u5EFA/\u4F9D\u8D56\u548C\u539F\u7D20\u6750\u6743\u5229\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u672C\u6B21\u4EC5\u91CD\u65B0\u8BFB\u53D6\u6240\u5217\u5B98\u65B9\u8BF4\u660E\u3001\u8BB8\u53EF/\u8D39\u7528/\u9274\u6743\u6750\u6599\u5E76\u6838\u5BF9\u6B63\u6587\u3002\u6587\u6863\u53EF\u8BFB\u4E0D\u4EE3\u8868\u80FD\u529B\u8C03\u7528\u6210\u529F\uFF1B\u672A\u5B89\u88C5\u3001\u6267\u884C\u5019\u9009\u547D\u4EE4\u3001\u8C03\u7528\u80FD\u529BAPI\u3001\u4F7F\u7528\u8D26\u6237\u3001\u4E0A\u4F20\u8D44\u6599\u3001\u8BE2\u4EF7\u4E0B\u5355\u6216\u4ED8\u6B3E\u3002"
},
"author_name": null,
"schema_version": "navonavo.capability.v1",
"service_id": "cap-f1133c05e632d95fe2ec0545",
"version": 2,
"source_url": "https://openapi-generator.tech/docs/usage/",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "assistant",
"name": "NavoNavo documentation review"
},
"submitter_identity_verified": false,
"source_check": {
"url": "https://openapi-generator.tech/docs/usage/",
"final_url": "https://openapi-generator.tech/docs/usage/",
"status_code": 200,
"title": "Usage | OpenAPI Generator",
"description": "Options for OpenAPI Generator are the same whether you\u0027re using the CLI, Maven/Gradle Plugins, or Online generation options.",
"checked_at": "2026-10-20T11:55:06.8137964\u002B00:00",
"warnings": [
"\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
]
},
"created_at": "2026-10-20T11:55:06.8170888\u002B00:00",
"updated_at": "2026-10-31T00:09:28.2800662\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-f1133c05e632d95fe2ec0545?version=2",
"page_url": "https://navonavo.com/capabilities/cap-f1133c05e632d95fe2ec0545?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"deep_card": {
"schema_version": "navonavo.deep-card.v1",
"dictionary_version": "navonavo.conditions.v1",
"card_version": 2,
"updated_at": "2026-10-31T00:09:28.2792722\u002B00:00",
"review_state": "current",
"profiles": [
{
"profile_id": "openapi-generator-spec-validation-documentation",
"component_version": "documentation-sha256:8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"summary": "OpenAPI Generator\u516C\u5F00\u6587\u6863\uFF1B\u672A\u6838\u5B89\u88C5\u3001\u672A\u6267\u884C\uFF0C\u9650\u6240\u5217\u8F93\u5165\u8F93\u51FA\u3002",
"claims": [
{
"key": "invocation_mode",
"value": "cli",
"conclusion": "supported",
"evidence_refs": [
"openapi-generator-spec-validation-documentation-e1"
],
"unknown_reason": null
},
{
"key": "output_structure",
"value": "text",
"conclusion": "supported",
"evidence_refs": [
"openapi-generator-spec-validation-documentation-e2"
],
"unknown_reason": null
}
],
"connection": {
"entry": "openapi-generator-cli",
"protocol": "CLI",
"authentication": "unknown\uFF1B\u9009\u62E9\u672C\u5730\u6587\u4EF6\u4E0D\u7B49\u4E8E\u5916\u90E8\u5F15\u7528\u65E0\u9700\u8BA4\u8BC1\u6216\u6CA1\u6709\u7F51\u7EDC\u884C\u4E3A\u3002",
"environment": [
"\u4EC5\u5B98\u65B9\u6587\u6863\u58F0\u660E\uFF0C\u914D\u65B9proposed\uFF1B\u672C\u7AD9\u672A\u8FDE\u63A5\u3001\u6CE8\u518C\u3001\u8C03\u7528\u7B2C\u4E09\u65B9\u5DE5\u5177\u6216\u6838\u9A8C\u5B9E\u9645\u8D26\u6237\u3002",
"\u672C\u914D\u65B9\u53EAvalidate\uFF0C\u4E0Dgenerate\u6216\u6267\u884C\u751F\u6210\u7684\u4EE3\u7801\u3002",
"\u4E0D\u91C7\u7528URL\u8F93\u5165\uFF1B\u5916\u90E8$ref\u7684\u7F51\u7EDC\u884C\u4E3Aunknown\uFF0C\u4E0D\u4FDD\u8BC1\u79BB\u7EBF\u3002",
"\u5B89\u88C5\u3001\u5E73\u53F0\u3001\u5F53\u524D\u7248\u672C\u3001\u9000\u51FA\u7801\u8BED\u4E49\u53CA\u8D39\u7528unknown\u3002"
],
"pricing_status": "unknown",
"quota_status": "unknown"
},
"recipe": {
"recipe_id": "openapi-generator-spec-validation-documentation-recipe",
"revision": 1,
"required_capabilities": [
"validate_openapi_specification"
],
"preconditions": [
"\u4EC5\u5B98\u65B9\u6587\u6863\u58F0\u660E\uFF0C\u914D\u65B9proposed\uFF1B\u672C\u7AD9\u672A\u8FDE\u63A5\u3001\u6CE8\u518C\u3001\u8C03\u7528\u7B2C\u4E09\u65B9\u5DE5\u5177\u6216\u6838\u9A8C\u5B9E\u9645\u8D26\u6237\u3002",
"\u672C\u914D\u65B9\u53EAvalidate\uFF0C\u4E0Dgenerate\u6216\u6267\u884C\u751F\u6210\u7684\u4EE3\u7801\u3002",
"\u4E0D\u91C7\u7528URL\u8F93\u5165\uFF1B\u5916\u90E8$ref\u7684\u7F51\u7EDC\u884C\u4E3Aunknown\uFF0C\u4E0D\u4FDD\u8BC1\u79BB\u7EBF\u3002",
"\u5B89\u88C5\u3001\u5E73\u53F0\u3001\u5F53\u524D\u7248\u672C\u3001\u9000\u51FA\u7801\u8BED\u4E49\u53CA\u8D39\u7528unknown\u3002"
],
"steps": [
"\u51C6\u5907\u5DF2\u83B7\u6388\u6743\u7684\u6700\u5C0F\u8F93\u5165\uFF0C\u6838\u5BF9\u672Cprofile\u7684\u9002\u7528\u8303\u56F4\u3001\u8BA4\u8BC1\u4E0E\u8D39\u7528\uFF1B\u4E0D\u586B\u79C1\u4EBA\u4FE1\u606F\u6216\u51ED\u636E\u5230\u516C\u5F00\u793A\u4F8B\u3002",
"openapi-generator-cli validate -i LOCAL_SPEC.yaml",
"\u672A\u6765\u83B7\u51C6\u6267\u884C\u540E\u6838\u5BF9\u5B9E\u9645\u8BCA\u65AD\u3001\u8F93\u51FA\u6587\u4EF6\u6216\u5BF9\u8C61\u4E0E\u8F93\u5165\u6761\u4EF6\uFF0C\u4FDD\u7559\u7F3A\u9879\u548C\u8FD0\u884C\u9519\u8BEF\uFF1B\u672C\u6B21\u6CA1\u6709\u6267\u884C\u6B64\u6B65\u9AA4\u3002"
],
"input_contract": "\u83B7\u51C6\u7684\u672C\u5730OpenAPI specification\uFF1B\u6587\u6863\u793A\u4F8BYAML\uFF0C\u5916\u90E8\u5F15\u7528\u53CA\u7F51\u7EDC\u6761\u4EF6\u9700\u53E6\u5916\u6838\u5BF9\u3002",
"output_contract": "\u6587\u672C\u8BCA\u65AD\uFF0C\u5305\u62EC\u65E0\u9A8C\u8BC1\u95EE\u9898\u6216\u7F3A\u5C11info\u7B49\u9519\u8BEF\uFF1B\u4E0D\u4FDD\u8BC1\u6240\u6709\u89C4\u8303\u7248\u672C\u8986\u76D6\u6216\u673A\u5668\u53EF\u8BFB\u7ED3\u6784\u3002",
"validation": "\u672A\u6765\u6838\u672C\u5730\u8DEF\u5F84\u3001\u5F15\u7528\u8303\u56F4\u3001\u8BCA\u65AD\u4E0E\u9000\u51FA\u72B6\u6001\uFF0C\u4E0D\u81EA\u52A8\u4FEE\u590D\u6216\u6267\u884C\u751F\u6210\u4EE3\u7801\uFF1B\u672C\u7AD9\u672A\u6267\u884C\u3002",
"failure_fallback": "\u6761\u4EF6\u4E0D\u6EE1\u8DB3\u3001\u8BA4\u8BC1/\u9650\u6D41/\u7ED3\u6784\u9519\u8BEF\u5373\u505C\u6B62\u8BE5\u8C03\u7528\u5E76\u4FDD\u7559unknown\uFF1B\u4E0D\u5207\u6362\u4ED8\u8D39\u670D\u52A1\u3001\u4E0D\u731C\u5DE5\u5177\u540D\u3001\u4E0D\u6267\u884C\u5199\u64CD\u4F5C\u3002"
}
}
],
"evidence": [
{
"evidence_id": "openapi-generator-spec-validation-documentation-e1",
"evidence_type": "documentation",
"source_url": "https://openapi-generator.tech/docs/usage/",
"locator": ".local/deep-cards-v1/cli-sdk-batch-20261024-05/sources/openapi-generator-spec-validation-documentation.txt:L160-L169",
"excerpt": "The validate command allows you to validate an input specification, optionally providing recommendations for error fixes or other improvements (if available).\nopenapi-generator-cli help validate\nNAME\n openapi-generator-cli validate - Validate specification\nSYNOPSIS\n openapi-generator-cli validate\n (-i \u003Cspec file\u003E | --input-spec \u003Cspec file\u003E) [--recommend]\nOPTIONS\n -i \u003Cspec file\u003E, --input-spec \u003Cspec file\u003E\n location of the OpenAPI spec, as URL or file (required)",
"source_version": "documentation-sha256:8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"content_sha256": "8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"collected_at": "2026-10-20T11:07:14.745259\u002B00:00",
"profile_ids": [
"openapi-generator-spec-validation-documentation"
],
"covers": [
{
"key": "invocation_mode",
"value": "cli"
}
],
"execution": null
},
{
"evidence_id": "openapi-generator-spec-validation-documentation-e2",
"evidence_type": "documentation",
"source_url": "https://openapi-generator.tech/docs/usage/",
"locator": ".local/deep-cards-v1/cli-sdk-batch-20261024-05/sources/openapi-generator-spec-validation-documentation.txt:L171-L180",
"excerpt": "Valid Spec Example (using petstore-v3.0.yaml)\nopenapi-generator-cli validate -i petstore-v3.0.yaml\nValidating spec (petstore-v3.0.yaml)\nNo validation issues detected.\nInvalid Spec Example (using petstore-v3.0-invalid.yaml):\nopenapi-generator-cli validate -i petstore-v3.0-invalid.yaml\nValidating spec (petstore-v3.0-invalid.yaml)\nErrors:\n -attribute info is missing\n[error] Spec has 1 errors.",
"source_version": "documentation-sha256:8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"content_sha256": "8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"collected_at": "2026-10-20T11:07:14.745259\u002B00:00",
"profile_ids": [
"openapi-generator-spec-validation-documentation"
],
"covers": [
{
"key": "output_structure",
"value": "text"
}
],
"execution": null
}
]
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-f1133c05e632d95fe2ec0545",
"card_version": 2,
"selected_profile_id": null,
"state": "documented",
"review_state": "current",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-f1133c05e632d95fe2ec0545?version=2",
"page_url": "https://navonavo.com/capabilities/cap-f1133c05e632d95fe2ec0545?version=2",
"profiles": [
{
"profile_id": "openapi-generator-spec-validation-documentation",
"component_version": "documentation-sha256:8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"summary": "OpenAPI Generator\u516C\u5F00\u6587\u6863\uFF1B\u672A\u6838\u5B89\u88C5\u3001\u672A\u6267\u884C\uFF0C\u9650\u6240\u5217\u8F93\u5165\u8F93\u51FA\u3002",
"conditions": [
{
"key": "invocation_mode",
"value": "cli",
"state": "T",
"reason": "Supported within this profile and component version.",
"evidence_refs": [
"openapi-generator-spec-validation-documentation-e1"
]
},
{
"key": "output_structure",
"value": "text",
"state": "T",
"reason": "Supported within this profile and component version.",
"evidence_refs": [
"openapi-generator-spec-validation-documentation-e2"
]
}
],
"connection": {
"entry": "openapi-generator-cli",
"protocol": "CLI",
"authentication": "unknown\uFF1B\u9009\u62E9\u672C\u5730\u6587\u4EF6\u4E0D\u7B49\u4E8E\u5916\u90E8\u5F15\u7528\u65E0\u9700\u8BA4\u8BC1\u6216\u6CA1\u6709\u7F51\u7EDC\u884C\u4E3A\u3002",
"environment": [
"\u4EC5\u5B98\u65B9\u6587\u6863\u58F0\u660E\uFF0C\u914D\u65B9proposed\uFF1B\u672C\u7AD9\u672A\u8FDE\u63A5\u3001\u6CE8\u518C\u3001\u8C03\u7528\u7B2C\u4E09\u65B9\u5DE5\u5177\u6216\u6838\u9A8C\u5B9E\u9645\u8D26\u6237\u3002",
"\u672C\u914D\u65B9\u53EAvalidate\uFF0C\u4E0Dgenerate\u6216\u6267\u884C\u751F\u6210\u7684\u4EE3\u7801\u3002",
"\u4E0D\u91C7\u7528URL\u8F93\u5165\uFF1B\u5916\u90E8$ref\u7684\u7F51\u7EDC\u884C\u4E3Aunknown\uFF0C\u4E0D\u4FDD\u8BC1\u79BB\u7EBF\u3002",
"\u5B89\u88C5\u3001\u5E73\u53F0\u3001\u5F53\u524D\u7248\u672C\u3001\u9000\u51FA\u7801\u8BED\u4E49\u53CA\u8D39\u7528unknown\u3002"
],
"pricing_status": "unknown",
"quota_status": "unknown"
},
"recipe": {
"recipe_id": "openapi-generator-spec-validation-documentation-recipe",
"revision": 1,
"required_capabilities": [
"validate_openapi_specification"
],
"preconditions": [
"\u4EC5\u5B98\u65B9\u6587\u6863\u58F0\u660E\uFF0C\u914D\u65B9proposed\uFF1B\u672C\u7AD9\u672A\u8FDE\u63A5\u3001\u6CE8\u518C\u3001\u8C03\u7528\u7B2C\u4E09\u65B9\u5DE5\u5177\u6216\u6838\u9A8C\u5B9E\u9645\u8D26\u6237\u3002",
"\u672C\u914D\u65B9\u53EAvalidate\uFF0C\u4E0Dgenerate\u6216\u6267\u884C\u751F\u6210\u7684\u4EE3\u7801\u3002",
"\u4E0D\u91C7\u7528URL\u8F93\u5165\uFF1B\u5916\u90E8$ref\u7684\u7F51\u7EDC\u884C\u4E3Aunknown\uFF0C\u4E0D\u4FDD\u8BC1\u79BB\u7EBF\u3002",
"\u5B89\u88C5\u3001\u5E73\u53F0\u3001\u5F53\u524D\u7248\u672C\u3001\u9000\u51FA\u7801\u8BED\u4E49\u53CA\u8D39\u7528unknown\u3002"
],
"steps": [
"\u51C6\u5907\u5DF2\u83B7\u6388\u6743\u7684\u6700\u5C0F\u8F93\u5165\uFF0C\u6838\u5BF9\u672Cprofile\u7684\u9002\u7528\u8303\u56F4\u3001\u8BA4\u8BC1\u4E0E\u8D39\u7528\uFF1B\u4E0D\u586B\u79C1\u4EBA\u4FE1\u606F\u6216\u51ED\u636E\u5230\u516C\u5F00\u793A\u4F8B\u3002",
"openapi-generator-cli validate -i LOCAL_SPEC.yaml",
"\u672A\u6765\u83B7\u51C6\u6267\u884C\u540E\u6838\u5BF9\u5B9E\u9645\u8BCA\u65AD\u3001\u8F93\u51FA\u6587\u4EF6\u6216\u5BF9\u8C61\u4E0E\u8F93\u5165\u6761\u4EF6\uFF0C\u4FDD\u7559\u7F3A\u9879\u548C\u8FD0\u884C\u9519\u8BEF\uFF1B\u672C\u6B21\u6CA1\u6709\u6267\u884C\u6B64\u6B65\u9AA4\u3002"
],
"input_contract": "\u83B7\u51C6\u7684\u672C\u5730OpenAPI specification\uFF1B\u6587\u6863\u793A\u4F8BYAML\uFF0C\u5916\u90E8\u5F15\u7528\u53CA\u7F51\u7EDC\u6761\u4EF6\u9700\u53E6\u5916\u6838\u5BF9\u3002",
"output_contract": "\u6587\u672C\u8BCA\u65AD\uFF0C\u5305\u62EC\u65E0\u9A8C\u8BC1\u95EE\u9898\u6216\u7F3A\u5C11info\u7B49\u9519\u8BEF\uFF1B\u4E0D\u4FDD\u8BC1\u6240\u6709\u89C4\u8303\u7248\u672C\u8986\u76D6\u6216\u673A\u5668\u53EF\u8BFB\u7ED3\u6784\u3002",
"validation": "\u672A\u6765\u6838\u672C\u5730\u8DEF\u5F84\u3001\u5F15\u7528\u8303\u56F4\u3001\u8BCA\u65AD\u4E0E\u9000\u51FA\u72B6\u6001\uFF0C\u4E0D\u81EA\u52A8\u4FEE\u590D\u6216\u6267\u884C\u751F\u6210\u4EE3\u7801\uFF1B\u672C\u7AD9\u672A\u6267\u884C\u3002",
"failure_fallback": "\u6761\u4EF6\u4E0D\u6EE1\u8DB3\u3001\u8BA4\u8BC1/\u9650\u6D41/\u7ED3\u6784\u9519\u8BEF\u5373\u505C\u6B62\u8BE5\u8C03\u7528\u5E76\u4FDD\u7559unknown\uFF1B\u4E0D\u5207\u6362\u4ED8\u8D39\u670D\u52A1\u3001\u4E0D\u731C\u5DE5\u5177\u540D\u3001\u4E0D\u6267\u884C\u5199\u64CD\u4F5C\u3002"
},
"evidence": [
{
"evidence_id": "openapi-generator-spec-validation-documentation-e1",
"evidence_type": "documentation",
"source_url": "https://openapi-generator.tech/docs/usage/",
"locator": ".local/deep-cards-v1/cli-sdk-batch-20261024-05/sources/openapi-generator-spec-validation-documentation.txt:L160-L169",
"excerpt": "The validate command allows you to validate an input specification, optionally providing recommendations for error fixes or other improvements (if available).\nopenapi-generator-cli help validate\nNAME\n openapi-generator-cli validate - Validate specification\nSYNOPSIS\n openapi-generator-cli validate\n (-i \u003Cspec file\u003E | --input-spec \u003Cspec file\u003E) [--recommend]\nOPTIONS\n -i \u003Cspec file\u003E, --input-spec \u003Cspec file\u003E\n location of the OpenAPI spec, as URL or file (required)",
"source_version": "documentation-sha256:8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"content_sha256": "8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"collected_at": "2026-10-20T11:07:14.745259\u002B00:00",
"profile_ids": [
"openapi-generator-spec-validation-documentation"
],
"covers": [
{
"key": "invocation_mode",
"value": "cli"
}
],
"execution": null
},
{
"evidence_id": "openapi-generator-spec-validation-documentation-e2",
"evidence_type": "documentation",
"source_url": "https://openapi-generator.tech/docs/usage/",
"locator": ".local/deep-cards-v1/cli-sdk-batch-20261024-05/sources/openapi-generator-spec-validation-documentation.txt:L171-L180",
"excerpt": "Valid Spec Example (using petstore-v3.0.yaml)\nopenapi-generator-cli validate -i petstore-v3.0.yaml\nValidating spec (petstore-v3.0.yaml)\nNo validation issues detected.\nInvalid Spec Example (using petstore-v3.0-invalid.yaml):\nopenapi-generator-cli validate -i petstore-v3.0-invalid.yaml\nValidating spec (petstore-v3.0-invalid.yaml)\nErrors:\n -attribute info is missing\n[error] Spec has 1 errors.",
"source_version": "documentation-sha256:8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"content_sha256": "8e735124a6f6be96fdf196a436899244d171c6c515aa51d5fbca6afeeee5193b",
"collected_at": "2026-10-20T11:07:14.745259\u002B00:00",
"profile_ids": [
"openapi-generator-spec-validation-documentation"
],
"covers": [
{
"key": "output_structure",
"value": "text"
}
],
"execution": null
}
]
}
],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}