跳转到正文
使用文档
简
English简体中文繁體中文
工作空间
指南API 参考API v1
指南

发送第一个请求

创建工作空间 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

写入操作还需要密钥具有写入访问权限。每个接口会列出完整的所需权限。新建只读密钥默认不包含凭据读取权限。

支出限额限制该密钥累计从钱包扣除的金额,退款不会恢复限额。设置了支出限额的密钥不能开启自动续费。

妥善保存密钥

在服务器或可信的本地工具中使用密钥,不要写入公开网站、代码仓库或共享日志。密钥丢失后,请撤销并重新创建。

接下来可以购买静态代理或生成动态连接。