欢迎使用阿里云API网关服务。用户可以使用本文档介绍的API对API网关服务进行相关操作。
请确保在使用这些接口前,已充分了解了API网关产品说明、使用协议和收费方式。
术语表
术语 | 全称 | 中文 | 说明 |
---|---|---|---|
Region | 地域 | 用户开放API,需选择API在API网关的部署地域,建议选择与后端服务相同的Region。 | |
API | 应用程序编程接口 | 用户开放API,在API网关录入API,以提供接口的方式对外提供服务或者数据。 | |
Group | API Group | API分组 | 一组API。
|
SubDomain | 分组二级域名 | 用户开放API,创建的每个API分组都有一个二级域名,独立域名需要解析到该二级域名上,直接访问该域名可以调用测试环境的API。 | |
CustomDomain | Custom Domain | 域名 | 用户开放API,需要绑定自己的独立域名,该域名需要CNAME解析到分组二级域名上且在阿里云备案或备案接入。且若支持HTTPS协议,还需为域名上传SSL合规证书。 |
Stage | 环境 | 用户开放API,创建的每个API分组目前有两个环境,测试和线上。用户操作API发布到某个环境后,API才能被调用。区别在于,直接访问分组二级域名调用API,默认是调用测试环境。 | |
Signature | Backend Signature | 后端签名密钥 | 用于开放API的用户给API网关颁发身份验证密钥。后端签名密钥绑定到API后对绑定的API即时生效。网关接收到这些API的请求,再去请求后端服务的时候就会带上签名信息,供后端服务对API网关做身份校验。 |
TrafficControl | 流量控制策略(简称“流控策略”) | 用于开放API的用户对API做访问流控。流控策略与API绑定后对绑定的API即时生效。流控策略可以从Api、App、User三个维度管控API的调用。流控策略下还可以配置特殊流控,如某App/User在调用绑定的API时,可以按照特殊的值来流控。 | |
Special | Special Traffic Control | 特殊流量控制(简称“特殊流控”) | 是流控策略的一个配置,可以指定某App/User,针对流控策略绑定的API,按照单独的值进行流控。 |
APP | 应用 | 调用其他用户开放的API时,需要创建一个APP作为调用者的身份。请求到达网关时,会对AppKey和AppSecret进行签名校验。 |
业务限制资源规格限制说明
在API网关中,对每个用户可创建的API分组、API个数都有限制,对用户经过API网关调用开放的API也有限制。详情请参考官网文档对使用限制的说明 使用限制。
在接口说明部分,凡出现与官网上给出的限制发生矛盾时,均以官网的限制说明为准。