API类商品使用
本文介绍的是:当用户在云商店购买API商品后,如何调用API接口,如您购买的是大模型API类商品,请参见大模型API类商品使用。
API认证方式概述
在调用API商品时,首先您需要了解采用哪种API认证方式,云商店API商品的认证方式可以支持"签名认证、简单身份认证(AppCode、MCPAppCode)"两种方式。两种方式可同时使用,您可以根据不同情况来选择。
签名认证(推荐):客户端程序使用AppSecret,对一系列需要签名所需要的信息 (详见请求签名说明文档和签名SDK)进行哈希运算(一般会使用 hmacSha256 算法),得到签名结果(一串字符串)。在调用API时,Request Header增加签名结果和AppKey的内容,从而进行身份认证。
简易认证:
- AppCode:客户端程序将AppCode放到Request Header中,或者放到Request的Query参数中,从而进行身份认证(详见AppCode请求说明文档),如何获取appcode请参考为简易认证添加AppCode。
- MCPAppCode(推荐):MCP(Model Context Protocol)是一个开放协议,旨在打通大语言模型(LLM)应用与外部数据源、工具之间的交互壁垒。使用MCPAppCode接入可以更高效、更便捷地实现Agent应用与成千上万的外部工具与数据的互通,极大提升了开发效率和灵活性,如何使用MCPAppCode接入请参考MCP类商品使用指导。
API商品计费规则
|
API商品类型 |
HTTP状态码(HTTP Status Code) |
调用接口时间 |
|
按次套餐包 |
任何状态码 |
2025年7月16日前 |
|
HTTP 2XX [200,300) |
2025年7月16日起 |
|
|
按需、按需套餐包 |
HTTP 2XX [200,300) |
/ |
查询API商品调用认证信息
用户购买成功后,可以到"云商店-买家中心-已购买服务"中,查看API调用所需要的认证信息,认证信息是由APIG网关统一创建。
操作步骤
- 在订单支付成功页单击“返回我的云商店”,或在云商店首页单击“买家中心”,进入到“我的云商店>已购买的服务”商品列表页。

- 在已购买的服务列表中找到该商品的名称,单击右侧操作栏的“资源详情”,可查看商品的基本信息、应用的AppKey/AppSecret、已使用的调用次数等信息。

- 单击“应用信息>接口信息”中“查看接口”的按钮,跳转到商品详情页查看。

- 在商品详情页“API接口”区可查看接口URL;

① 单击“API调用方法”,前往帮助中心查看API调用详细说明;
② 单击“调试API”,跳转至APIG控制台页面进行接口调试;

- 按照详情页应用信息中的使用指南进行使用,若使用指南描述不清晰,请根据商家信息中的联系方式,联系商家提供服务。
