检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API文档按照模板进行写作 本条规则是Should类型的扩展规则，可提升API调用者的使用体验。 API对外开放时，API文档建议使用统一的模板，以便保持API参考文档的一致性，易于开发者理解。在API参考文档中必须包含如下内容： API目录，包括本次提供API的列表信息。 API名称及API功能介绍。 API请求方法和URI。
最新动态 本文介绍了API中心各特性版本的功能发布和对应的文档动态，欢迎体验。 2023年7月 序号 功能名称 功能描述 阶段 相关文档 1 优化服务商入驻 仅支持华为云账号入驻API中心服务商，不允许该账号下的IAM用户入驻API中心服务商。 商用 服务商入驻 2 优化变更服务商信息
通过对接集成，API中心为开发者引入API生产工具：API Arts。 API设计、测试一站式高效协同，API数据自动同步。 API设计与文档实时同步，设计即文档。 API测试与设计同源，设计示例一键导入测试步骤。 API开放简单体验 一键上架：API生产工具中的API资产可以一键上架到API门户，实现开放分享。
公告，应当至少提前6个月在文档标识（使用@deprecated）为不建议使用（在此期间该接口仍要能完成正常的功能），并提供替换方式的处理。 新版本API为兼容旧版本，增加的字段不建议作为强制填写的字段，字段取值范围不建议小于原有的取值范围。 API文档记录API接口变更 本条规则
企业期望将自身业务能力（如实时快递查询服务）通过API接口对外开放，供外部伙伴/开发者调用集成，构建更繁荣的业务系统生态，并且触达更广泛的业务范围。 准备工作 准备好API接口文档，推荐OpenAPI 2.0/3.0格式。 准备好API使用指南，说明API凭据获取方式、以及提供API使用时的补充说明信息。 API对应
服务商入驻 为什么要申请入驻服务商？ 申请入驻API中心服务商有哪些入口？ 服务商入驻审核多久通过？ 服务商入驻成功后可以取消入驻吗？ 服务商入驻成功后信息还可以修改吗？
修订记录 发布日期 修订记录 2023-05-06 第四次正式发布。 新增如下章节： 服务商入驻成功后可以取消入驻吗？ 服务商入驻成功后信息还可以修改吗？ 2023-04-10 第三次正式发布。 优化如下章节： 为什么要申请入驻服务商？ 申请入驻API中心服务商有哪些入口？ 服务商入驻审核多久通过？
产品功能 表1 API中心功能概览 功能名称 功能描述 发布区域 API设计和测试 API开发者可使用API中心工具库中的API生产工具（如华为云API Arts），进行API的设计、测试等。 华北-北京四 服务商入驻 API开发者可在线申请入驻成为API中心的服务商。 华北-北京四
附录-API治理规范指导 概述 规范要求 工具平台
概述 简介 术语 父主题： 附录-API治理规范指导
规范要求 API生产 API开放 父主题： 附录-API治理规范指导
API网关代理 是否必须使用API中心的网关代理功能？ 哪些API支持在线调测？ 如何获取API调用凭据？
API售卖与技术支持 如何对API进行商业售卖？ 谁为API使用者提供技术支持？
修订记录 发布日期 修订记录 2023-05-31 第七次正式发布。 优化如下章节： 上架API至API中心门户网站 2023-03-31 第六次正式发布。 优化如下章节： 上架API至API中心门户网站 消费API 2023-03-22 第五次正式发布。 优化如下章节： 生产API
开放API 上架API至API中心门户网站 注册API到网关代理
API网关代理 概述 API分组 API列表 API策略 API凭据管理 调用已发布的API
API列表 创建API 导入API 导出API 发布API 授权API 调试API 下线API 开启跨域访问 父主题： API网关代理
API策略 创建策略 流量控制策略说明 访问控制策略说明 签名密钥策略说明 负载通道 环境管理 父主题： API网关代理
调用已发布的API 调用API 响应消息头 错误码 父主题： API网关代理
修订记录 发布日期 修订记录 2023-07-14 第九次正式发布。 优化如下章节： 服务商入驻 变更服务商信息 API资产管理 2023-05-06 第八次正式发布。 新增如下章节： 取消入驻服务商 优化如下章节： 服务商入驻 变更服务商信息 负载通道 2023-03-31 第七次正式发布。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
