# AppKey 与接口权限管理

在开发者中心查找产品 AppKey、确认有效期与权限，并完成一次接入验证。

## 核心步骤

- 登录购买接口时使用的账号。
- 按产品名称或 API 标识查找 AppKey。
- 确认有效期后复制凭据，保存在服务端。
- 用最小请求核对接口权限与实际响应。

## 适用场景与准备

适合购买接口后开始接入，或排查“有 AppKey 但无法调用”的情况。准备目标产品名称或 API 标识，登录购买时使用的账号。指南可以公开阅读，具体 AppKey 和订单需要登录 [开发者中心](https://www.gugudata.com/portal/) 后查看。

## 查找并复制 AppKey

1. 打开“APP KEY 管理”，按需要选择“全部”“使用中”或“已过期”。
2. 输入产品名称或 API 标识，点击“查询 AppKey”。不确定名称时先清空关键字，查看全部记录。
3. 核对 API 产品、APPKEY 有效期和状态，确认选中的是目标接口。
4. 点击该行“复制”，将凭据保存到服务端环境变量或密钥管理工具；复制失败时可手动复制并检查是否带入空格。

关键字也支持 AppKey，但不需要为了查找产品而把密钥放入截图或分享链接。拿到凭据后的请求头写法见 [鉴权与 AppKey](https://www.gugudata.com/developers/authentication)。

## 如何理解列表中的状态

| 页面信息 | 可以确认什么 | 还需要核对什么 |
| --- | --- | --- |
| API 产品 | 当前记录对应的接口 | 请求路径与参数是否属于同一产品 |
| APPKEY 有效期 | 页面显示的授权期限 | 是否需要续费，以及当前订单状态 |
| 使用中或已过期 | 当前记录的状态 | 调用频率、额度和实际业务响应 |
| 续费或升级入口 | 当前可办理的操作 | 结算页的产品、费用与生效期限 |

复制成功只表示凭据进入剪贴板，不表示调用已经成功。订阅与次数包的权益规则不同，应结合 [订单与续费管理](https://www.gugudata.com/developers/portal/orders) 核对购买方式，不能仅凭 AppKey 字符串判断还有多少可用次数。

## 完成后验证

按 [快速开始](https://www.gugudata.com/developers/getting-started) 发起一次最小请求，同时核对 HTTP 状态、业务状态和返回字段。验证可能按目标接口规则消耗次数，避免反复执行大批量请求。

## 常见问题

| 问题 | 处理方法 |
| --- | --- |
| 找不到已购买接口 | 确认登录账号，重置筛选条件，再查看订单是否已支付 |
| 显示使用中但调用失败 | 检查产品与 AppKey 是否匹配，再排查参数、额度和限流 |
| 接口已过期 | 从对应记录的续费入口核对价格与有效期，完成后重新查看权限 |
| 怀疑凭据泄露 | 移除公开内容并检查异常调用，通过官方支持确认凭据处理方式，不假定存在自助重置功能 |

遇到无法解释的权限差异时，保留产品名称、订单号和脱敏错误响应，通过 [官方支持](https://www.gugudata.com/contact) 反馈；不要发送完整 AppKey。