# APIG网关类商品技术对接方案
#### 简介
- 商家上架API商品时，为保证用户正常使用 API 服务，需要在华为云APIG共享版网关上部署相关 API 服务。
- 商家提供的在线API接口作为商品，用户购买API商品后，可以通过服务的调用地址来获取相关的服务，并按调用次数计费。
![](https://support.huaweicloud.com/usermanual-marketplace/public_sys-resources/caution_3.0-zh-cn.png)
1. 目前华为云云商店支持**华北** **-** **北京四** 、**华南** **-** **广州** 、**华东** **-** **上海一** 的**共享网关**API发布到云商店，请确保创建的API分组所在区域为以上区域；
2. 当前只支持APIG共享版网关对接云商店进行售卖，由于APIG共享版网关不再新增用户，控制台无直接访问入口，请单击下方[表1]的进行访问；
3. 使用共享版网关会产生相关的费用； ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002524346959.png "点击放大")
   重要风险提示：若您的华为云账号欠费，将直接造成存量客户无法正常调用 API 接口，同时新客户无法下单购买相关服务。请您实时关注账户余额，保持账户余额充足，避免客户业务中断。
   
 
 表1**共享网关访问链接** 
| **Region**      | **访问链接**                                                                                                                                     |
|:---|:---|
| **华北-** **北京四** | [单击访问](https://console.huaweicloud.com/apig/?agencyId=36813e69052d48459c9375ae167e3f48&locale=zh-cn#/apig/multiLogical/multiLogicalOverview) |
| **华南-** **广州**  | [单击访问](https://console.huaweicloud.com/apig/?agencyId=36813e69052d48459c9375ae167e3f48&locale=zh-cn#/apig/multiLogical/multiLogicalOverview) |
| **华东-** **上海一** | [单击访问](https://console.huaweicloud.com/apig/?agencyId=36813e69052d48459c9375ae167e3f48&locale=zh-cn#/apig/multiLogical/multiLogicalOverview) |
   
#### API商品扣费规则
| API商品类型                                    | HTTP状态码（HTTP Status Code） | 调用接口时间      | 备注                                              |
|:---|:---|:---|:---|
| 按次套餐包                                      | 任何状态码                     | 2025年7月16日前 | 请商家保证API 接口在异常的情况下，返回非2XX 的HttpCode，例如：500、400。 |
| 按次套餐包                                      | HTTP 2XX \[200,300)       | 2025年7月16日起 | 请商家保证API 接口在异常的情况下，返回非2XX 的HttpCode，例如：500、400。 |
| 按需 按需套餐包 | HTTP 2XX \[200,300)       | /           | 请商家保证API 接口在异常的情况下，返回非2XX 的HttpCode，例如：500、400。 |
   
#### 操作步骤
1. 创建API分组。 
   1. 左侧导航选择"开放API \> API分组"，单击"创建分组"。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002492253408.png "点击放大")
      
   
   2. 输入分组名称、描述，单击确定。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002492413398.png "点击放大")
      
   
   
   
   
2. 创建API。 
   1. 单击目标API分组所在行的"API管理"，单击"新建API"，进入API信息设置页面。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002524373107.png "点击放大")
      
   
   2. 设置"API名称"、"所属分组"、"类型"、"安全认证"等信息，确认信息无误后单击"下一步"。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002524413125.png "点击放大")
      ![](https://support.huaweicloud.com/usermanual-marketplace/public_sys-resources/caution_3.0-zh-cn.png)
      - 上架云商店的接口，只支持"APP认证"类型，否则无法上架。
      
      - 建议您的接口打开"支持简易认证"方式，支持APPCODE方式调用，让用户使用curl命令获取API服务，更高效、便捷。
        
   
   3. 设置"请求协议"、"请求Path"、"匹配模式"、"Method"、"接口入参"等信息，单击"下一步"。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002492253410.png "点击放大")
      
   
   4. 设置"协议"、"请求方式"、"使用VPC通道"、"后端服务地址""后端超时时间"等信息，单击"下一步"。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002492413400.png "点击放大")
      
   
   5. 设置"成功响应示例""失败响应示例"等信息，单击"完成"。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002524373109.png "点击放大")
      ![](https://support.huaweicloud.com/usermanual-marketplace/public_sys-resources/note_3.0-zh-cn.png)
      - 具体的参数说明请参考[《API网关用户指南》](https://support.huaweicloud.com/usermanual-apig/apig-ug-180307020.html)；
      
      - 请求体和返回结果的内容结构请使用JSON格式，云商店会将数据用于生成在线接口示例，供用户参考使用API服务。
        
   
   
   
   
3. 调测和发布API。 
   1. 返回API管理页面，单击目标API所在行操作列的"调试"按钮，按照接口要求填写相关参数进行在线调试，并且需业务处理与预期一致，才能进行发布API上架，避免用户购买后无法使用。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002524413127.png "点击放大")
      ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002492253412.png "点击放大")
      
   
   2. 返回API管理页面，单击目标API所在行右侧的"发布"按钮，进入API发布页面。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002492413402.png "点击放大")
      
   
   3. 选择发布环境、输入发布API的说明后，单击"发布"按钮。 ![](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_image_0000002524373111.png "点击放大")
      ![](https://support.huaweicloud.com/usermanual-marketplace/public_sys-resources/note_3.0-zh-cn.png)
      若需要的发布环境不存在，单击"创建新环境"去创建新的发布环境。