# 发送第一个请求

创建工作空间 API 密钥，用只读请求验证接入。

## 创建密钥

打开[工作空间的 API 密钥页面](https://portal.migoip.com/app/api-keys)，为你的应用创建密钥。密钥只展示一次，请立即保存。

第一个请求只需要只读访问与 `account:read`。按需要添加权限，并设置到期时间、允许访问的 IP 范围或支出限额。

## 确认工作空间

调用 `GET /account` 确认工作空间。在本地环境设置 `MIGO_API_KEY`，然后运行：

```sh
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` |

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

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

## 妥善保存密钥

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

接下来可以[购买静态代理](/zh-cn/docs/guides/static-proxies)或[生成动态连接](/zh-cn/docs/guides/dynamic-proxies)。