本文旨在帮助已开通白名单的API Portal体验用户创建API门户、创建云产品并完成API文档上架。

如您的企业也有OpenAPI的诉求，请点击报名链接进行申请，工作人员将与您取得联系。报名点我>>

1      创建及编辑API门户

    1.1 点击全部门户中的“+”

    1.2 新建门户

        1.2.1 填写企业API门户名称（必填）。该名称将用于对外开放OpenAPI或在内部协作时展示，请您规范填写。例如填入您的企业简称或产品名称。

        1.2.2 填写门户描述。请对您的门户进行描述，例如您的产品能力、面向行业等内容。

        1.2.3 选择所属行业。

        1.2.4 设置访问权限。如您选择“公开”，那么全部访客均可访问您的API门户，但订阅和调试则需要注册华为云账号；如您选择“私人”，则仅有同一租户下的IAM账号可以访问。

        1.2.5 填写联络人信息。包括联络人名称及联络人电子邮箱。

        1.2.6 点击“确定”完成API门户创建。

    1.3 设置门户

        1.3.1 点击进入您已创建的API门户

        1.3.2 点击右侧导航栏中“门户设置”，对门户进行编辑

        1.3.3 进入门户设置后，您可以上传门户图标、更改门户Banner、设置是否显示联络人信息，并修改您在2节中完成的设置内容。

        1.3.4 您也可以将您的门户链接复制后，发送给他人。如您不需要此门户，也可以删除门户（建议您谨慎执行该操作）。

        1.3.5 完成修改后，系统自动保存。

2      创建及编辑云产品

    2.1 点击“新增云产品”

    2.2 填写您的云产品名称及云产品描述，然后点击“确定”。

    2.3 编辑云产品。点击需要编辑的云产品，您可以更改云产品图标、云产品名称、云产品描述，也可以删除云产品。

3      导入Swagger文件

    3.1 如您已有.yaml或.yml格式文件，可直接上传。点击右侧导航栏中“OpenAPI”，选择您要上传Swagger文件的云产品，点击“导入Swagger文件”，点击上传或拖入Swagger文件。

    3.2 如您没有.yaml或.yml格式文件，您可以通过华为云CodeArts API或Swagger编辑器设计API，并生成.yaml或.yml格式文件。当前华为云CodeArts API处于邀测阶段，如您需要体验试用，可点击报名>>，工作人员与您取得联系后，将为您开通试用白名单。

    3.3 完成上传后点击发布，即生成了您的一个云产品API文档

    3.4 点击门户预览即可查看您已创建的云产品及API，您的开发者可在门户内实现在线调试、调试结果查看、代码示例生成等更多操作。