写点什么

十大功能特性,助力开发者玩转 API Explorer

  • 2023-07-14
    广东
  • 本文字数:1972 字

    阅读完需:约 6 分钟

十大功能特性,助力开发者玩转API Explorer

本文分享自华为云社区《10大功能特性,助力开发者玩转华为云API Explorer》,作者:华为云 PaaS 服务小智。


伴随着我国 API 生态逐渐成熟、市场发展不断完善,API 已广泛应用在以网页、移动应用、后端系统集成为主的众多开发场景中。同时,开发者对 API 的主要诉求已由获取数据能力转变为获取技术能力、甚至业务能力,开发者渴望更加高效便捷的调用方式,除关注 API 产品本身性能外,也愈发关注优质的服务和使用体验。


在企业业务需求不断扩大、系统接入的云服务不断增多的同时,企业开发人员需要引入和维护的 API 也越多。开发者面临以下难题:


  1. 面对冗杂的 API 说明文档,查阅困难

  2. 调试接口或排除故障时无法可视化处理

  3. 从 0 开始开发底层代码,降低效率

  4. 运维人员需在控制台上配置并管理云资源


为解决开发者的以上难题,华为云 API Explorer 为开发者提供一站式 API 解决方案统一平台,集成华为云服务所有开放 API,支持全量快速检索、可视化调试、帮助文档、代码示例等能力,帮助开发者快速查找、学习 API 和使用 API 开发代码。

满足开发者应用开发全场景


华为云 API Explorer 开放平台全方位助力开发者的各类应用开发场景,包括但不限于微服务场景、App 场景、Web 场景、IoT 场景、AI 场景、小程序场景等,支持 18 大类 194+产品服务,7000+开放 API,搭载华为云计算、网络、存储、应用服务、软件开发服务、视频、数据库、EI 智能等 200+产品服务,8900+API 和 15000+错误码,590 个 SDK。


十大功能特性,助力开发者玩转 API Explorer

● API 在线搜索


华为云 API Explorer 的 API 在线搜索功能,可帮助开发者快速检索,支持开发者基于 API Explorer 全局搜索云产品服务或 API,同时支持开发者按产品搜索 API。开发者在登录后,也可通过 API Explorer 门户快速查看最近搜索/使用的产品或 API。开发者也可在 API Explorer 上关注常用产品 API


● API 参数可视化调试


API Explorer 支持常用 YAML 定义参数表格化、可视化可见即得的参数描述及示例说明,可帮助开发者快速理解参数结构,并支持开发者在线可视化调试 API,可根据自动获取的错误码详情,快速定位问题、解决问题,从而提高开发效率。在全新升级的 API Explorer 中,开发者在登录状态下,可自动获取 Region、Token、Project_id 参数值,避免开发者人工查找,提高调试效率。


● API 文档


API 文档包含了规范的文档结构、接口说明、请求参数/示例、返回参数/示例、错误码、SDK 等,开发者可以快速查阅 API 详情和参数说明,并可通过文档上的相关链接了解云产品的服务功能


● 代码示例


代码示例功能支持开发者使用 Java、Python、Go、.NET、PHP、C、C++等多种主流开发语言调用 SDK 来访问华为云开放 API,帮助开发者快速了解 API 的底层工作原理,开发者在基于华为云服务进行应用开发时,可以直接引用示例代码,避免开发者重复开发底层代码,提高编程效率。


● SDK 中心


华为云全新设计的 SDK V3 版本,提供统一的 SDK 使用方式。开发者可通过添加依赖或下载的方式调用华为云 API,访问华为云应用、资源和数据。SDK 为开发者提供详细的代码示例,便于开发者快速集成、快速开发。

● 错误码搜索查看


API Explorer 提供产品全部错误码的搜索查看功能,开发者可基于全局或在产品内搜索错误码,根据错误码说明解决问题。


● API 问答


开发者可以使用华为云 API 问答助手,对 API、SDK、报错解决方案、云产品等问题进行咨询,快速获取解决方案,同时开发者可在 API 问答界面中提交工单、提出建议反馈等

● API 诊断


当开发者开发、调试华为云 API 出现错误时,可使用 API 诊断服务查询解决方案、调用链路、CLS 日志、相似错误码、API 文档等信息。

● CLI 参数生成


开发者在安装部署、变更升级、扩容等场景下,可以使用命令行的方式调用 OpenAPI,管理和使用各类云服务资源,API 参数可自动生成 CLI 命令行参数,开发者可使用 CLI 示例在线调试。开发者也可以使用华为云命令行工具服务(KooCLI)完成以上操作。


● Terraform Explorer


开发者可通过 Terraform 在线、可视化地创建、管理、编排华为云资源,并对其进行版本控制。

API Explorer 快速入门


在使用 API Explorer 前,您需要完成如下准备工作:


● 注册华为账号

● 完成实名认证

● 创建IAM用户并授权

● 获取访问密钥(AK/SK)


完成后,即可进入 API Explorer 进行调试。点击进入


以弹性云服务器 -- 查询 API 版本信息列表为例


  • 点击弹性云服务器



  • 点击查询 API 版本信息 – NovaListVersions(查询 API 版本信息列表)



  • 点击“调试”按钮



  • 查看调试结果及错误码


  • 查看代码示例(以 Java 语言为例)


小贴士:API Explorer 是否收费?


API Explorer 本身是免费的,但如果您在使用部分接口调用涉及付费云产品,则会产生计费。例如,当您使用 API Explorer 的模板创建代码工程,并将代码工程导入代码仓库时,由于该功能涉及到项目管理和代码托管两个服务,因此可能由于超出这两个服务的免费范围而产生计费。详情请见华为云定价


戳我立即体验华为云API Explorer


点击关注,第一时间了解华为云新鲜技术~

发布于: 刚刚阅读数: 2
用户头像

提供全面深入的云计算技术干货 2020-07-14 加入

生于云,长于云,让开发者成为决定性力量

评论

发布
暂无评论
十大功能特性,助力开发者玩转API Explorer_云计算_华为云开发者联盟_InfoQ写作社区