APIG网关类商品技术对接方案

简介

商家上架API商品时，为保证用户正常使用 API 服务，需要在华为云APIG共享版网关上部署相关 API 服务。
商家提供的在线API接口作为商品，用户购买API商品后，可以通过服务的调用地址来获取相关的服务，并按调用次数计费。

目前华为云云商店支持华北-北京四、华南-广州、华东-上海一的共享网关API发布到云商店，请确保创建的API分组所在区域为以上区域；
当前只支持APIG共享版网关对接云商店进行售卖，由于APIG共享版网关不再新增用户，控制台无直接访问入口，请单击下方表1的进行访问；
使用共享版网关会产生相关的费用；

表1 **共享网关访问链接**
Region	访问链接
华北-北京四	点击访问
华南-广州	点击访问
华东-上海一	点击访问

API商品扣费规则

API商品类型	HTTP状态码（HTTP Status Code）	调用接口时间	备注
按次套餐包	任何状态码	2025年7月16日前	请商家保证API 接口在异常的情况下，返回非2XX 的HttpCode，例如：500、400。
HTTP 2XX [200,300)	2025年7月16日起
按需按需套餐包	HTTP 2XX [200,300)	/

API商品类型

HTTP状态码（HTTP Status Code）

调用接口时间

备注

按次套餐包

任何状态码

2025年7月16日前

请商家保证API 接口在异常的情况下，返回非2XX 的HttpCode，例如：500、400。

HTTP 2XX [200,300)

2025年7月16日起

按需

按需套餐包

HTTP 2XX [200,300)

操作步骤

创建API分组。
1. 左侧导航选择“开放API > API分组”，单击“创建分组”。
2. 输入分组名称、描述，单击确定。
创建API。
1. 单击目标API分组所在行的“API管理”，单击“新建API”，进入API信息设置页面。
2. 设置“API名称”、“所属分组”、“类型”、“安全认证”等信息，确认信息无误后单击“下一步”。
  - 上架云商店的接口，只支持“APP认证”类型，否则无法上架。
  - 建议您的接口打开“支持简易认证”方式，支持APPCODE方式调用，让用户使用curl命令获取API服务，更高效、便捷。
3. 设置“请求协议”、“请求Path”、“匹配模式”、“Method”、“接口入参”等信息，单击“下一步”。
4. 设置“协议”、“请求方式”、“使用VPC通道”、“后端服务地址”“后端超时时间”等信息，单击“下一步”。
5. 设置“成功响应示例”“失败响应示例”等信息，单击“完成”。
  - 具体的参数说明请参考《API网关用户指南》；
  - 请求体和返回结果的内容结构请使用JSON格式，云商店会将数据用于生成在线接口示例，供用户参考使用API服务。
调测和发布API。
1. 返回API管理页面，单击目标API所在行操作列的“调试”按钮，按照接口要求填写相关参数进行在线调试，并且需业务处理与预期一致，才能进行发布API上架，避免用户购买后无法使用。
2. 返回API管理页面，单击目标API所在行右侧的“发布”按钮，进入API发布页面。
3. 选择发布环境、输入发布API的说明后，单击“发布”按钮。
  
  若需要的发布环境不存在，单击“创建新环境”去创建新的发布环境。