活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 618智算钜惠季 爆款云主机2核4G限时秒杀,88元/年起!
  • 免费体验DeepSeek,上天翼云息壤 NEW 新老用户均可免费体验2500万Tokens,限时两周
  • 云上钜惠 HOT 爆款云主机全场特惠,更有万元锦鲤券等你来领!
  • 算力套餐 HOT 让算力触手可及
  • 天翼云脑AOne NEW 连接、保护、办公,All-in-One!
  • 中小企业应用上云专场 产品组合下单即享折上9折起,助力企业快速上云
  • 息壤高校钜惠活动 NEW 天翼云息壤杯高校AI大赛,数款产品享受线上订购超值特惠
  • 天翼云电脑专场 HOT 移动办公新选择,爆款4核8G畅享1年3.5折起,快来抢购!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

智算服务

打造统一的产品能力,实现算网调度、训练推理、技术架构、资源管理一体化智算服务
智算云(DeepSeek专区)
科研助手
  • 算力商城
  • 应用商城
  • 开发机
  • 并行计算
算力互联调度平台
  • 应用市场
  • 算力市场
  • 算力调度推荐
一站式智算服务平台
  • 模型广场
  • 体验中心
  • 服务接入
智算一体机
  • 智算一体机
大模型
  • DeepSeek-R1-昇腾版(671B)
  • DeepSeek-R1-英伟达版(671B)
  • DeepSeek-V3-昇腾版(671B)
  • DeepSeek-R1-Distill-Llama-70B
  • DeepSeek-R1-Distill-Qwen-32B
  • Qwen2-72B-Instruct
  • StableDiffusion-V2.1
  • TeleChat-12B

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入云市场创新解决方案
办公协同
  • WPS云文档
  • 安全邮箱
  • EMM手机管家
  • 智能商业平台
财务管理
  • 工资条
  • 税务风控云
企业应用
  • 翼信息化运维服务
  • 翼视频云归档解决方案
工业能源
  • 智慧工厂_生产流程管理解决方案
  • 智慧工地
建站工具
  • SSL证书
  • 新域名服务
网络工具
  • 翼云加速
灾备迁移
  • 云管家2.0
  • 翼备份
资源管理
  • 全栈混合云敏捷版(软件)
  • 全栈混合云敏捷版(一体机)
行业应用
  • 翼电子教室
  • 翼智慧显示一体化解决方案

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云云市场合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
  • 天翼云EasyCoding平台
天翼云培训认证
  • 天翼云学堂
  • 天翼云市场商学院
天翼云合作计划
  • 云汇计划
天翼云东升计划
  • 适配中心
  • 东升计划
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
开放能力
  • EasyCoding敏捷开发平台
培训与认证
  • 天翼云学堂
  • 天翼云认证
魔乐社区
  • 魔乐社区

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 建议与反馈
  • 用户体验官
  • 服务保障
  • 客户公告
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 天翼云4.0
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 智算服务
  • 产品
  • 解决方案
  • 应用商城
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心
      文档中心

      API网关

      API网关

        • 产品动态
        • 产品简介
        • 产品定义
        • 功能特性
        • 产品优势
        • 应用场景
        • 约束与限制
        • 基本概念
        • 计费说明
        • 公测实例转正式商用
        • 产品价格
        • 到期与欠费
        • 快速入门
        • 购买专享版实例
        • 修改专享版实例
        • 用户指南
        • 概述
        • API管理
        • 开放API流程
        • 创建API分组
        • 创建API
        • 绑定域名
        • 调试API
        • 创建环境(可选)
        • 发布API
        • 调用API
        • 调用API流程
        • 创建凭据并获取授权
        • 为简易认证添加AppCode
        • 调用API
        • 开放API网关
        • API分组管理
        • 创建API分组
        • 绑定域名
        • 删除分组
        • 新增网关响应
        • API管理
        • 创建API
        • 开启跨域访问
        • 调试API
        • 授权API
        • 发布API
        • 下线API
        • 删除API
        • 导入API
        • 导出API
        • 流量控制
        • 创建流控策略
        • 删除流控策略
        • 添加特殊凭据或租户
        • 删除特殊凭据或租户
        • 访问控制
        • 创建访问控制策略
        • 删除访问控制策略
        • 环境管理
        • 创建环境和环境变量
        • 删除环境
        • 签名密钥
        • 创建并使用签名密钥
        • 删除签名密钥
        • 负载通道
        • 创建负载通道
        • 删除负载通道
        • 自定义认证
        • 创建自定义认证
        • 删除自定义认证
        • 调用API网关
        • 应用管理
        • 创建凭据并获取授权
        • 删除凭据
        • 重置Secret
        • 为简易认证添加AppCode
        • 查看凭据绑定的API详情
        • SDK介绍
        • 调用已发布的API
        • 调用API
        • 响应消息头
        • 错误码
        • 审计
        • 审计
        • 最佳实践
        • APIG开放CCE云容器应用
        • 最佳实践概述
        • 资源规划
        • 通过API访问CCE最佳实践
        • API网关跨VPC开放后端服务
        • 场景描述
        • 操作流程
        • 实施步骤
        • 常见问题
        • 热门咨询
        • API注册
        • API调用
        • API认证鉴权
        • API控制策略
        • API发布
        • API导入导出
        • API安全
        • 其他
        • 文档下载
        • 用户使用手册
        • 相关协议
        • 公测产品服务协议
        • 天翼云API网关产品服务协议
          无相关产品

          本页目录

          帮助中心API网关常见问题API调用
          API调用
          更新时间 2024-09-30 13:57:35
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          最近更新时间: 2024-09-30 13:57:35
          分享文章
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          本章主要介绍API调用常见问题。

          API调用失败的可能原因有哪些?

          如果API调用出错,请仔细检查API的配置:

          • 域名是否备案成功,且能正常解析。
          • 域名是否绑定到正确的API分组。
          • API是否已发布。如果修改过API,则需要重新发布;如果发布到非RELEASE环境,请求X-Stage头的值需要填写发布的环境名称。
          • 如果使用APP认证,App Key和Secret是否正确。
          • 访问控制策略是否设置正确。
          • 是否超过了流量控制范围。
          • 请求参数的格式错误。

          API调用报错“414 Request-URI Too Large”

          可能原因:URL(包括请求参数)太长,建议将请求参数放在body体中传递。

          "API Not Found"如何解决?

          请按以下顺序排查可能原因:

          1.API的方法不正确。比如注册的API为POST方法,您使用了GET方法调用。

          2.API没有发布。API创建后,需要发布到具体的环境后才能使用。

          3.域名解析不正确。如果API方法正确,且已发布到环境,有可能是没有准确解析到您的API所在分组。请检查API所在的分组域名,例如您有多个API分组,每个分组有自己的独立域名,API调用时,使用了其他分组的独立域名。

          No backend available,怎么解决?

          检查后端服务是否可以访问,如果不能访问,请修改后端服务。

          • 检查后端服务对应的ECS安全组配置,查看是否已开放您需要的端口。
          • 检查VPC网络中的ACL配置,查看是否有相关ACL策略限制了API网关实例与后端服务所在子网的通信。
          • 若使用VPC通道,检查VPC通道业务端口、健康检查端口、后端服务器添加是否均正常。

          后端服务调用失败或超时原因分析

          以下原因可能导致后端服务调用失败或者超时,请逐一排查。

          原因 解决方案
          后端服务地址错误。 在编辑API中修改后端服务地址。如果是域名,请确认域名能正确解析到后端服务IP地址。
          后端超时时间设置不合理。当后端服务没有在设置的后端超时时间内返回时,API网关提示后端服务调用失败。 在编辑API中增加后端超时时间。
          如果“后端服务地址”在ECS(Elastic Cloud Server),ECS的安全组的出/入方向规则可能拦截了请求。 检查后端服务所在ECS的安全组,确保出/入方向端口规则和协议都设置正确。
          请求协议配置错误,如后端服务为HTTP,在API网关配置为HTTPS。 注册的API与后端服务配置相同的协议。

          修改后端服务的超时时间上限“backend_timeout”后未生效

          问题描述

          修改专享版APIG实例参数“backend_timeout”后未生效。

          可能原因

          在“定义后端服务”中,“后端超时(ms)”未修改。

          解决方法

          登录控制台,在“API管理”中,进入目标API详情,单击“编辑”,在“定义后端服务”中配置“后端超时(ms)”。

          如何切换调用环境?

          默认调用“发布”环境的API。如果您要调用其他环境的API,请添加请求消息头X-Stage,参数值填写环境名称。

          调用请求包最大支持多少?

          专享版:API每次最大可以转发Body体为12MB的请求包。请求body体超过12M时,根据业务需求,请在“实例概览”的配置参数中修改“request_body_size”参数。“request_body_size”表示API请求中允许携带的Body大小上限,支持修改范围1~9536 M。

          使用iOS系统时,如何进行APP认证?

          目前API网关为APP认证提供了Java、Python、C、PHP、Go等多种语言的SDK与demo,当您使用iOS系统(Objective-C语言)或者其他未包含在内的语言时,请参考“开发指南 > 使用APP认证调用API > APP认证工作原理”的指导进行APP认证。

          最多支持创建多少个APP?

          每个用户最多创建50个APP。

          APP认证的API,怎样实现不同的第三方之间无法知道对方调用情况?

          创建多个APP,并绑定同一个API,分发给不同的第三方不一样的APP。

          APP认证的API,有没有限制可以给多少个第三方使用?

          没有限制。

          APP认证的API,是否需要自己创建APP?

          是,需要自行创建APP,并绑定API。创建完成APP后,系统自动生成AppKey和AppSecret,将AppKey和AppSecret给第三方,就可以直接调用此API了。

          APP认证的API,第三方怎么调用?

          您需要把AppKey和AppSecret提供给第三方,然后第三方通过SDK调用。具体SDK的调用步骤请参见“开发指南 > 使用APP认证调用API”。

          是否支持移动应用调用API?

          API支持被移动应用调用。使用APP认证时,将移动应用的AppKey和AppSecrect替换SDK中的AppKey和AppSecrect进行APP签名。

          如何实现WebSocket数据传输?

          API网关支持WebSocket数据传输,在创建API时,请求协议中的HTTP相当于WebSocket的ws,HTTPS相当于WebSocket的wss。

          API调用是否支持长连接

          API网关支持长连接,但注意适当使用,避免占用太多资源。

          策略后端有多个时,怎么匹配和执行

          当您的API配置了多个策略后端,API网关会按顺序进行匹配,匹配到其中一个立即执行API请求转发,不会进行后续的匹配。

          当策略后端都没有匹配成功,则按照默认后端执行API请求的转发。

          API调用对请求的响应消息体限制

          API调用对请求的响应消息体大小没有限制。

          文档反馈

          建议您登录后反馈,可在建议与反馈里查看问题处理进度

          鼠标选中文档,精准反馈问题

          选中存在疑惑的内容,即可快速反馈问题,我们会跟进处理

          知道了

          上一篇 :  API注册
          下一篇 :  API认证鉴权
          搜索 关闭
          ©2025 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
          公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
          备案 京公网安备11010802043424号 京ICP备 2021034386号
          ©2025天翼云科技有限公司版权所有
          京ICP备 2021034386号
          备案 京公网安备11010802043424号
          增值电信业务经营许可证A2.B1.B2-20090001
          用户协议 隐私政策 法律声明