指南
发送第一个请求
创建工作空间 API 密钥,用只读请求验证接入。
点击接口可编辑请求并查看响应。
创建密钥
打开工作空间的 API 密钥页面,为你的应用创建密钥。密钥只展示一次,请立即保存。
第一个请求只需要只读访问与 account:read。按需要添加权限,并设置到期时间、允许访问的 IP 范围或支出限额。
确认工作空间
调用 GET/account 确认工作空间。在本地环境设置 MIGO_API_KEY,然后运行:
export MIGO_API_BASE='https://portal.migoip.com/api/customer/v1'
curl --fail-with-body "$MIGO_API_BASE/account" \
-H "Authorization: Bearer $MIGO_API_KEY"
成功响应会返回密钥所属的工作空间。无需在请求中添加工作空间 ID,也不需要浏览器登录会话。
选择权限
| 操作 | 权限 |
|---|---|
| 查看静态价格 | catalog:read |
| 查看静态资源 | proxies:read |
| 查看连接凭据 | credentials:read 及对应代理权限 |
| 创建静态订单 | orders:write、wallet:spend |
| 购买动态流量 | dynamic:write、wallet:spend |
| 查看动态设置和流量 | dynamic:read |
写入操作还需要密钥具有写入访问权限。每个接口会列出完整的所需权限。新建只读密钥默认不包含凭据读取权限。
支出限额限制该密钥累计从钱包扣除的金额,退款不会恢复限额。设置了支出限额的密钥不能开启自动续费。
妥善保存密钥
在服务器或可信的本地工具中使用密钥,不要写入公开网站、代码仓库或共享日志。密钥丢失后,请撤销并重新创建。