检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Markdown压缩包：支持导入Markdown编辑的API文件，且该文件需要压缩为zip包导入。 URL：填写您API资产的URL地址，系统会将URL地址内的API资产展示在API中心。 API Arts：支持从API Arts工具直接把开发好的API文件一键式导入API中心。 说明： 仅从API
Markdown压缩包：支持导入Markdown编辑的API文件，且该文件需要压缩为zip包导入。 URL：填写您API资产的URL地址，系统会将URL地址内的API资产展示在API中心。 API Arts：支持从API Arts工具直接把开发好的API文件一键式导入API中心。 说明： 仅从API
环境变量 API网关代理提供环境变量功能，通过创建环境变量，实现在不同的环境定义不同的API调用路径。 环境变量是指在环境上创建可管理的一种变量，该变量固定在环境上。通过创建环境变量，实现同一个API，在不同环境中调用不同的后端服务。 当创建API时定义了变量标识，则需要在环境中添加变量
API。 选择API需要发布到的环境，并填写发布说明。 如果API在选择的环境中已发布，再次发布即为覆盖该环境的API。 如果在选择环境时，没有自己需要的环境，单击“创建环境”链接，创建一个自己需要的环境。 单击“确定”，完成API发布。 已发布的API因为其他原因需要暂停对外提
Markdown压缩包：支持导入Markdown编辑的API文件，且该文件需要压缩为zip包导入。 URL：填写您API资产的URL地址，系统会将URL地址内的API资产展示在API中心。 API Arts：支持从API Arts工具直接把开发好的API文件一键式导入API中心。 说明： 仅从API
请求协议：选择协议类型，此处选择“HTTP”。 后端服务地址：后端服务的地址。 路径：后端服务的路径。 后端超时 后端服务请求的超时时间。此处默认“5000”ms。 在“返回结果基础定义”页面，定义返回结果。 表5 定义返回结果 信息项 描述 成功响应示例 成功调用API时，返回的响应信息示例。 失败响应示例
创建凭据并绑定API 使用APP认证的API，需要在API网关代理中创建一个凭据，以生成凭据ID和密钥对（Key、Secret）。将创建的凭据绑定API后，才可以使用APP认证调用API。 安全认证方式为“无认证”或“华为IAM认证”的API，无需创建凭据。 创建凭据 进入API中心服务页面。
阅该API的应用不能因为增加了新的查询条件而造成查询虚拟机列表失败。 API请求HTTP动词使用标准化且满足幂等性 本条规则是Should类型的扩展规则，可提升API的可维护性。 HTTP方法的需要符合幂等性的约束，幂等性的约束是指一次和多次请求某一个资源应该具有同样的副作用，单
问分组内的API。您也可以使用系统分配的调试域名访问API分组内的API。 调试域名：API分组创建后，系统为分组自动分配一个内部测试用的调试域名，此调试域名唯一且不可更改，每天最多可以访问1000次。 独立域名：您自定义的域名，API调用者通过访问独立域名来调用您开放的API。
能说明API的用途，场景及约束。 API描述信息建议使用Markdown格式编写，便于生成对应API文档，API描述信息长度建议不超过2000字符。 例如：发布API用于查询虚拟机列表。良好的API描述应为“通过虚拟机名称、IP地址、虚拟机型号查询当前租户下的虚拟机列表，列表包括
配置AppCode 信息项 描述 生成方式 选择AppCode的生成方式。 自动生成：由系统随机生成AppCode。 手动输入：自定义AppCode。 AppCode 仅手动输入方式需要填写AppCode的值。 使用AppCode进行API请求的简易认证 在创建API时，选择“APP认证”并且开启“支持简易认证”。
一键上架：API生产工具中的API资产可以一键上架到API门户，实现开放分享。 API消费快速匹配 支持智能搜索和推荐，缩短应用开发者和API资产的触达路径，帮助应用开发者快速找到所需API。 支持在线调测，快速试用和体验API。 与华为云集成工作台对接集成，支持API快速生成连接器，并用于SaaS开发和集成。
安全性 API使用合适的认证模式 本条规则是Should类型的扩展规则，可提升API的安全性。 根据具体业务场景，选择API调用的认证模式，具体说明如表1所示。 表1 认证模式说明 认证模式 认证描述 AppKey 在API请求Header或者Query中携带AppId和AppK
PI中心管理控制台的以下功能： API资产分享：通过创建API资产，将您开发好的API分享至API中心门户网站，供其他开发者搜索和调用。 API网关代理：API网关代理包括API的创建、发布、下线和删除所经历的完整生命周期过程，为您提供高性能、高可用、高安全的API托管服务。 A
网关代理传过来的Authorization头中签名是否一致，来校验API网关代理的合法性。 使用限制 同一个环境中，一个API只能被一个签名密钥绑定，一个签名密钥可以绑定多个API。 使用流程 图1 签名密钥流程图 在API中心管理控制台创建签名密钥。 将新创建的签名密钥绑定API。
看API的详细信息。 获取API的调用凭据 需要付费购买的API（来源于华为云市场的API），可按照页面引导和提示，完成API购买，然后在“买家中心>已购买的服务”中看到商品信息，单击“资源详情”可查看API调用凭据（AppKey/AppSecret）。 不需要付费购买的API（
主备容灾，保障服务的持久性与可靠性。 表1 API中心可靠性架构 可靠性方案 简要说明 跨Region容灾 全局级部件支持跨Region容灾，当主Region异常后，全局业务可以切换到备Region继续运行。 双AZ容灾 Region级部件实现跨AZ双活，一个AZ异常时不影响云服务持续提供服务。
可维护性 保证API日志采集的实时性及完整性 本条规则是MUST类型的基本规则，可保障API的可维护性。 在采集API调用日志过程中，需要保证API日志的实时性和完整性，以提升API分析的精准度。 API日志在传递过程中，必须保证传递日志不会出现丢失。API日志总体丢失率小于0.5%。
API网关代理中，已创建的API的总个数。数据1个小时刷新一次。 API分组总数 API网关代理中，已创建的API分组的总个数。数据1个小时刷新一次。 API请求总数 API网关代理中，已发布的所有API被调用的总次数。数据10分钟刷新一次。 API请求失败总数 API网关代理中，已发布的所有AP
生命周期管理：对API变更和下线等提出规范要求或建议，保障已订阅API租户的业务连续性。 包含Must类型的基本规则以及Should类型的扩展规则。Must规则牵引API开发者提供符合企业级标准、安全合规的API，Should规则在提供更全面指导的基础上，给予开发者灵活的弹性空间，方便开发者更快地加入API生态圈。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
