跳到主要内容

Developer Portal API Product Publication

概述

本教程将引导您完成在开发者门户上创建和发布 API 产品的过程。在 APIM 中,产品将多个 API 组合在一起,并允许您定义产品级元数据,例如标题、描述、徽标和文档链接。已发布的产品将对开发者可见,以便进行发现和使用。

先决条件

  • 至少有一个已部署的 API 可在您的 APIM 控制台中使用
  • 管理员访问权限到 管理 > 产品管理

分步教程

步骤 1. 创建新产品

导航到 管理 > 产品管理,然后点击加号按钮。

在弹出窗口中:

  • 输入产品名称:sk01
  • 点击确认以继续。

步骤 2. 填写基本产品信息

创建产品后,您将被重定向到详细信息页面。

Field Example
名称sk01(自动填充)
描述身份验证和用户管理 API
产品介绍链接https://developers.skapim.co.kr/product/sk01/overview
启用产品勾选(在开发者门户上显示)
启用 API 文档链接勾选(在产品详细信息页面激活 API 文档访问)
产品图标icon-sk01.png(1:1 比例,显示大小 40x40px)

点击保存以保存基本信息。

步骤 3. 将 API 添加到产品

切换到产品详细视图中的 API 选项卡。

点击添加按钮将 API 分配给此产品。

可用的 API 字段:

字段示例
项目mj-test-kong
网关mj-test-kong-gateway
APItestFromBff0052
描述helloworld2222
标签

点击勾选图标以完成添加。

您可以:

  • 添加多个 API
  • 移除 API(X 图标)
  • 查看或编辑每个 API(齿轮或查看图标)

第 4 步。在开发者门户上激活产品

返回产品列表,您将看到您的新条目。

描述
复选框切换以在开发者门户上发布或隐藏产品
顺序定义产品列表中的显示顺序(0 = 顶部)

编辑显示位置后,点击保存顺序。

最佳实践

  • 保持产品名称有意义且独特
  • 使用 1:1 比例图标(40x40 像素)以保持一致的显示
  • 将相关的 API 组合成一个产品以便于发现
  • 使用产品介绍链接将用户连接到文档或业务概述
  • 使用标签进行内部组织和前端过滤