帮你捋顺 API 网关的 API、SDK和错误排查

简介: 整理一下 API 网关资源和错误排查方法,让用户快速定位问题。
+关注继续查看

API 网关的特殊之处

  用户使用 API 网关开放 API 服务,或者调用其他人开放的 API 服务。而且 API 网关自身也开放了管理接口 API。所以用户使用时需要弄清楚两套 API、两套 SDK、两套错误码。这里把这些资源整理一下,方便大家正确使用和问题排查。

开发资源List

  APIs

  •   用户在 API 网关开放的 API 服务,如天气查询 API等
  •   API 网关开放的管理接口,用于使用产品,如创建 API等

  SDKs

  •   API 网关为天气查询等用户开放的 API 服务提供的 SDK 样例
  •   API 网关为自身管理接口提供的 SDK

  错误码

  •   用户请求其他用户开放的 API 时产生的报错,如未授权、被流控、购买次数已用完等
  •   用户请求 API 网关管理接口时产生的报错,如AccessKeyId错误、时间戳格式不对等

请求用户开放的 API 服务接口

  场景一般为用户开放 API 进行自测,或者用户要使用其他用户开放的 API 服务。如天气查询 API、人脸识别 API等。
  目前对此类 API 请求的 SDK 支持有6种语言的 SDK 示例和2种移动端语言的 SDK。可以在 API 网关控制台 SDK下载页面获取。位置如图:

3a0a534642c6008e11e71db3937e393a10df6bb3
  
  页面同时给出了两种移动端 SDK 的使用手册。
  请求 API 获得返回结果时要注意获取一下返回结果的 Header 部分,有时候可能需要抓一下包,很多用户打印出的返回结果都只是 Body 部分。如果请求没有成功,关键的错误信息就在返回结果的 Header 里,其中 X-Ca开头的字段为 API 网关返回的信息。
  X-Ca-Request-Id 为请求唯一 ID,用户可以提供这个信息给客服/技术支持人员,方便搜索日志。建议用户后端也记录一下这个值,便于联调排查。X-Ca-Error-Message 为具体错误信息,如Quota Exhausted、Invalid Url、Invalid Signature等,基本看错误码可以知道错误原因,若不确定,可千万错误码表查询。针对出现率较高的错误,API 网关还提供了详细的排查说明,点此查看。请关注 API 网关的帮助文档中心。

请求 API 网关开放的管理接口 API

  用户使用 API 接口代替控制台的操作,接口均为管理类接口,如CreateApiGroup、CreateApi等,详见 API 概览表
  目前 API 网关为这些 API 提供了 Java 语言的 SDK,与其他产品的 SDK 是统一规范,请在官网 Java SDK 页面获取。
  API 请求失败返回的错误信息在 Body 里,有errorcode和errormessage两个字段。errorcode为错误说明短语,errormessage为一段详细描述及建议。此类错误同样可以在错误码表查询。

祝使用顺利~ 有疑问请加用户交流旺旺群:1640106170

目录
相关文章
|
3月前
|
缓存 负载均衡 监控
php开发中大数据量优化的问题总结(1):smarty循环优化、API掉包丢失数据排查、负载平衡配置
php开发中大数据量优化的问题总结(1):smarty循环优化、API掉包丢失数据排查、负载平衡配置
53 0
|
9月前
|
消息中间件 移动开发 负载均衡
|
10月前
|
API
|
11月前
|
Java API 开发者
网关限流-API 分组维度|学习笔记
快速学习网关限流-API 分组维度
134 0
|
11月前
|
监控 前端开发 中间件
网关中间件研发首选一站式API协作平台:Eolink
大家好我是路飞,今天这篇文章和大家聊聊企业级网关中间件开发者,对API管理方面的需求,以及如何选择一款高效且功能强大的API管理工具。
|
前端开发 Java 应用服务中间件
如果让我设计一套,TPS 百万级 API 网关!
API 网关项目,是所有互联网大厂都有的一个核心服务,承接着来自用户的滴滴打车、美团外卖、京东购物、微信支付,更是大促期间千万级访问量的核心系统。 🤔 那么它是一个什么样的项目呢?为什么会有它的存在?它是怎么设计实现的呢?都用到了哪些技术栈呢?
349 0
如果让我设计一套,TPS 百万级 API 网关!
|
缓存 负载均衡 Kubernetes
SpringCloud升级之路2020.0.x版-3.Eureka Server 与 API 网关要考虑的问题
SpringCloud升级之路2020.0.x版-3.Eureka Server 与 API 网关要考虑的问题
SpringCloud升级之路2020.0.x版-3.Eureka Server 与 API 网关要考虑的问题
|
存储 JSON Cloud Native
云原生 API 网关,gRPC-Gateway V2 初探
云原生 API 网关,gRPC-Gateway V2 初探
532 0
|
负载均衡 前端开发 Cloud Native
API 网关选型及包含 BFF 的架构设计
在更通用的场景下我们会使用 NGINX 这样的软件做前置,用来处理SLB负载均衡过来的流量,作用是反向代理、集群负载均衡、转发、日志收集等功能。
API 网关选型及包含 BFF 的架构设计
|
设计模式 缓存 负载均衡
使用 API 网关
通常更好的方法是使用 API 网关。API 网关是一个服务器,是系统的单入口点。
181 0
相关产品
云迁移中心
推荐文章
更多