创建产品定义文件
通过创建产品定义文件来定义产品。
关于此任务
可通过以下任一方式来创建产品定义文件:
- 在您选择的编辑器中创建该文件。
- 使用
apic create:product命令创建产品定义文件,然后对其进行修改。 您可以将产品定义文件建立在缺省产品模板或您自己的定制模板的基础上。
可通过运行
apic create:product 并在命令行上提供其他自变量以在 CLI 中创建产品。 例如,可在一条命令中输入以下文本:apic create:product --name product_name --title product_title --filename product_file_name.yaml
--apis "filename_of_api1.yaml filename_of_api2.yaml"其中:- product_name 为新产品的名称。
- product_title 为新产品的标题。
- product_file_name.yaml 为针对新产品创建的 yaml 文件的名称。
- filename_of_api1.yaml 为新产品中使用的某一 API 的文件名。
- filename_of_api2.yaml 为新产品中使用的某一 API 的文件名。
apic
create:product,然后按照提示操作,以交互方式创建产品。您可以输入以下命令来查看
apic create:product 命令的进一步详细信息和可用选项:apic create:product --help您还可以使用以下命令,从定制 Handlebars 模板创建产品:
apic create:product --template template_filename --title product_title其中 template_filename 是要使用的 Handlebars 模板的名称,product_title 是产品的标题。 产品模板文件必须具有 .hbs 文件扩展名。 您可以从头开始创建模板,也可以从 API 和产品定义模板示例中提供的示例(默认)产品模板开始。产品定义文件包含以下节:
- 规范版本
- “信息”节
- “可视性”节
- API 节
- “计划”节
在此主题中,将使用 YAML,但可以调整指示信息来使用 JSON。 .yaml 和 .yml 文件扩展名都支持,但建议使用.yaml 文件扩展名。 yaml.org.
注: 本主题中指定的所有键和枚举值都区分大小写。
过程
完成以下步骤来组织产品定义文件:
结果
您已完成了产品的 YAML 表示。 带完整缩进的完整示例可在《 产品的 YAML 表示示例 》中找到。
您可以直接在 OpenAPI 定义中使用 x-ibm-languages 扩展来创建多语言 API 和产品文档。 有关详细信息,请参阅使用 x-ibm-languages 创建多语言 API 和产品文档。