AI 助理
文档备案控制台
官方文档
首页

API类相关问题

更新时间：
复制 MD 格式
我的收藏

1. 我在云市场购买了API商品，如何查看AppKey、AppCode？

请登录阿里云云市场控制台，进入我的服务页面查看相关信息。

2. 为什么在云市场控制台，查看AppCode、AppKey、AppSecret为空?

如您登录的是RAM用户，即右上角显示RAM用户。请登录主账号查看是否有给RAM用户授权以下权限：

  • 管理云市场(Marketplace)的权限：AliyunMarketplaceFullAccess

  • 管理网关服务(ApiGateway)的权限：AliyunApiGatewayFullAccess

详情可参考为RAM用户授权。

3. 如何重置AppSecret、AppCode？

  1. 请登录到API网关控制台-API调用-应用管理中找到对应应用，单击应用名称进入应用详情。

  2. 根据您的需求，单击AppKey或AppCode页签。在操作列单击重置AppSecret或重置AppCode，在确认重置弹窗中单击确定或单击自定义-根据页面提示输入修改后的AppSecret或AppCode，再单击确认。重置后相关接口也请做好更新。

    1. 在确认重置弹窗中单击确定，由系统默认生成AppSecret或AppCode。

    2. 在确认重置弹窗中，单击自定义，根据页面要求输入修改后的AppSecret或AppCode，单击确定。

说明

如您添加了密钥对，您的账号下将存在多个有效密钥对。您使用该账号在云市场购买的所有API类商品，使用其中任一密钥对均可调用成功。

4. 如何查看预付费API接口的套餐包使用情况?

  • 方式一：请登录阿里云云市场控制台，进入我的服务页面查看相关信息。单击套餐包列表查看每个套餐包的使用情况，单击使用明细查看每10分钟的调用次数。

  • 方式二：云市场支持用户购买API服务后，除通过云市场控制台查看剩余用量外，还支持通过Open API的方式进行配置查询，请API余量获取。

如需排查套餐包异常消耗，参见API套餐包凌晨异常消耗、怀疑被盗用怎么排查？

5. 如何查看按量计费API接口的资源包使用情况?

请登录阿里云云市场控制台，在我的服务页面找到相关商品，点击账单明细查看。详见账单详情。

6. 是否有Open API接口可以获取套餐包余量？

目前支持通过Open API的方式进行配置查询，请参考API余量获取的文档说明。

7. 我对API商品计次有疑问，如何查询调用IP？

  • 登录阿里云云市场控制台；在API Center列表中，单击API Inspector；

  • 在API调用记录追踪列表中，找到相关商品，在操作列点击导出IP调用记录查看调用IP(数据为T+1）。

如需排查套餐包异常消耗，参见API套餐包凌晨异常消耗、怀疑被盗用怎么排查？

8. 调用API接口报错，如何处理？

请先使用API自助排错工具进行排查,支持查询3天内的日志

9. 如何设置预付费次数包的余量预警通知阈值？

登录阿里云云市场控制台，单击左侧列表API/MCP Center中的API/MCP Tools，进入API/MCP用量提醒界面，在套餐包页签下，找到相关商品，在右侧操作列中单击编辑：

余量预警通知设置支持系统默认及自定义阈值两种：

  • 系统默认：默认有效实例剩余额度的20%（每次购买次数包，自动更新）

    举例：客户当前所有次数包剩余额度次数为2万次，提前增购1万次。此时余额提醒的阈值计算公式更新为（20000+10000）× 20%=6000，余量不足通知的触发阈值更新为6000次。

  • 自定义阈值：支持自定义比例和固定值两种：

    • 比例：计算规则同默认阈值一致，按有效实例的剩余额度比例进行计算。

      举例：客户当前所有次数包剩余额度次数为2万次，提前增购1万次；设置阈值比例为15%，此时余额提醒的阈值计算公式更新为（20000+10000）× 15%＝4500，余量不足通知的触发阈值更新为4500次。

    • 固定值：用户可按自身调用情况，自定义设置固定数值。

      举例：客户当前所有次数包剩余额度次数为2万次，提前增购1万次；设置固定值为5000，此时余量不足通知的触发阈值更新为5000次。

如需排查套餐包异常消耗，参见API套餐包凌晨异常消耗、怀疑被盗用怎么排查？

10. 如何设置余量预警通知的接收方式？

登录阿里云控制台进入消息中心，在左侧列表中单击消息接收管理-基本接收管理。消息类型选择「产品的欠费、停服、即将释放相关信息通知」，请确认保持勾选状态，避免余量预警通知无法正常接收；余量预警的通知方式当前支持短信和邮件。

11. 收到API套餐包/资源包即将到期的通知，如何复购？

请登录阿里云云市场控制台，进入我的服务页面。单击购买套餐包/购买资源包进行充值，购买后产生的调用优先从最先到期的套餐包/资源包抵扣。不过套餐包/资源包到期后余量将清零，且无法恢复，请您合理安排使用。

12. API商品是否有到期提醒？

当前预付费的API商品到期前系统会发送通知：

  • 发送方式：邮件、短信（不支持站内信）；

  • 发送逻辑：以商品维度根据套餐包最晚的到期时间发送到期通知，详见以下说明。

    • 如您同一个商品A在同一账号下购买了3次，分别于2025-07-01、 2025-08-01、2025-09-01 到期。系统只会在2025-09-01 到期前的一周通知您。（仅针对套餐包还有剩余次数的API进行提醒，如余量已为0 ，则不提醒）

13. 主账号能查看子账号购买的API订单吗？不同子账号相互之间的API订单，能相互隔离使用吗？

  • 主账号默认可以看到当前主账号以及主账号下所有子账号的订单。

  • 子账号在不授权的情况下，默认不能在云市场下单，也无法在买家控制台查看。授权AliyunMarketFullAccess后，可获得下单权限及查看所属主账号及该主账号下所有子账号的订单权限。查看授权方式：【RAM用户下单说明文档：AliyunMarketplaceFullAccess 】

  • 被授权的子账号订阅的API服务，同主账号下的不同子账号也能相互使用。

14. RAM子账号登录云市场后，在「我的服务」中看不到已购产品，如何处理？

RAM子账号查看我的服务中的已购产品，需同时满足以下两个条件：

  • 主账号已为该RAM用户授予AliyunMarketplaceFullAccess权限策略。该策略允许RAM用户查看主账号及所有子账号的订单和已购服务。授权方式参考为RAM用户授权。

  • 通过RAM用户专用登录地址登录，而非使用主账号登录页面。

15. 购买的第三方API商品停用了，如何处理？

第三方API商品的运行和维护由服务商负责。如果您购买的第三方API商品停用，请直接联系该API服务商确认停用原因及恢复方式。您可以在云市场商品详情页找到服务商的联系方式。

16. 购买新套餐包后，原有配置是否需要重新设置？

购买新套餐包后无需重新配置。产生的调用优先从最先到期的套餐包抵扣，新旧套餐包自动衔接。原有套餐包到期后余量清零，不影响新套餐包的使用和现有配置。

17. 如何配置API商品资源包余量不足的告警及告警联系人？

云市场支持对API商品的套餐包和资源包余量不足情况进行告警通知，配置分为两部分：

18. API套餐包凌晨异常消耗、怀疑被盗用怎么排查？

若API套餐包用量在非业务时段异常消耗，按以下步骤排查并阻断异常调用：

  1. 查看套餐包使用明细，确认异常时间段。登录阿里云云市场控制台，进入我的服务页面，单击套餐包列表查看使用情况，单击使用明细查看每10分钟的调用次数，定位异常消耗的具体时间段。详见如何查看预付费API接口的套餐包使用情况？

  2. 导出IP调用记录，定位异常来源。在云市场控制台API Center列表中，单击API Inspector，在API调用记录追踪列表中找到相关商品，在操作列单击导出IP调用记录，查看发起调用的IP地址（数据为T+1）。将导出的IP与自身业务服务器的IP对比，排查是否存在未知IP。详见我对API商品计次有疑问，如何查询调用IP？

  3. 重置AppCode/AppSecret，阻断异常调用。若确认存在非授权调用，登录API网关控制台应用管理，找到对应应用，单击应用名称进入应用详情，在操作列单击重置AppSecret或重置AppCode。重置后立即更新业务代码中的凭证。详见如何重置AppSecret、AppCode？

  4. 设置余量预警阈值，及时感知后续异常消耗。在云市场控制台单击API/MCP Center中的API/MCP Tools，进入API/MCP用量提醒界面，设置余量预警通知阈值。详见如何设置预付费次数包的余量预警通知阈值？

上一篇：用户相关问题下一篇：镜像类