更新时间:2023-12-08 GMT+08:00
分享

API资产管理

通过创建API资产,将您开发好的API分享至API中心门户网站,其他开发者就可以在API中心门户网站搜索到您分享的API,用于自己的项目开发。

前提条件

  • 已成功申请入驻成为API中心服务商。具体操作指导参见服务商入驻
  • 1个服务商最多可以创建50个API资产。
  • 1个服务商创建的所有API资产中API接口的总数量不能超过1000个。

创建API资产

  1. 进入API中心服务页面
  2. 选择左侧导航栏中的API资产管理 > API资产
  3. 单击页面右上角的“创建API资产”
  4. 填写API资产信息。

    1. 根据表1参数信息,配置选择导入API。
      表1 选择导入API

      参数名称

      说明

      导入方式

      支持以下6种方式,上架API文件至API中心门户网站:

      • OpenAPI:支持导入符合OpenAPI 2.0/3.0标准的txt、yml、yaml、json格式的API文件。
      • API网关:支持将API网关代理中已发布的API,上架至API中心门户网站。
      • Postman Collection:支持将Postman Collection开发的API,上架至API中心门户网站。
      • Markdown压缩包:支持导入Markdown编辑的API文件,且该文件需要压缩为zip包导入。
      • URL:填写您API资产的URL地址,系统会将URL地址内的API资产展示在API中心。
      • API Arts:支持从API Arts工具直接把开发好的API文件一键式导入API中心。
        说明:
        • 仅从API Arts工具导入API资产时,导入方式这里会显示“API Arts”页签。
        • 如果您的Markdown压缩包中文件的数量超过100个,导致文件无法导入,您可以通过向系统提交工单来寻求帮助。

      上传文件

      选择本地API文件上传。

      API分组

      “导入方式”选择“API网关”时,支持选择API网关代理中的API分组。

      API接口

      “导入方式”为下面几种之一时,支持勾选部分接口导入。如果导入全部接口,则忽略此参数。

      • OpenAPI
      • API网关
      • Postman Collection
      • API Arts

      API URL

      “导入方式”“URL”时,需要填写API资产的URL地址。

    2. 根据表2参数信息,配置资产基本信息。
      表2 资产基本信息

      参数名称

      说明

      资产名称

      自定义API资产的名称。

      说明:

      同一个华为云账号下的API资产名称不能重复。

      图标

      为API资产设置一个图标。如果不设置,则显示默认图标。

      资产简介

      简单介绍下API资产的行业,用途等。

      使用指南

      描述API的调用方法。

      资产域名

      API服务的主机域名或IP,用于API在线调试。

      分类

      选择API资产所属行业,方便API资产在API中心门户网站按行业类别被搜索。

      可见范围

      • 公开:创建API资产成功后,所有用户都能在API中心门户网站中看到该API资产。
      • 私有:创建API资产成功后,仅创建该API资产的用户能在API中心门户网站中看到该API资产。

      标签

      为该API资产添加个性标签,方便用户通过标签了解API资产的特点。

  5. 填写完API资产信息后,单击“立即创建”。

    等待系统解析API文件。API资产所在行“状态”列如果显示“已上架”,说明解析完成。此时,API资产已成功分享至API中心门户网站

如果您在华为云云商店上架了API资产,则API资产会周期性地自动上架至API中心门户网站,并展示在API资产列表页。

后续操作

创建完API资产后,您还可以执行表3的操作。

表3 后续操作

操作

说明

查看API资产详情

在API资产列表页,单击API资产名称,查看API资产详情。

修改API资产信息

在API资产列表页,单击API资产所在行“操作”列的“编辑”,修改API资产信息。

删除API资产

在API资产列表页,单击API资产所在行“操作”列的“删除”

查看API资产包含的接口信息

在API资产列表页,单击API资产所在行“状态”列的“查看”

相关文档