# 登录态 POST 提取接口

说明控制台登录态批量提取的请求字段、校验顺序、幂等和返回结果。

`POST /api/v1/proxy/extract` 用于已登录用户在控制台中批量提取代理地址。请求会校验实名、权益、白名单归属和参数。

## 请求结构

```json
{
  "requestId": "<request-id>",
  "entitlementId": "<entitlement-id>",
  "whitelistId": "<whitelist-id>",
  "country": "<country-code>",
  "quantity": 10,
  "protocol": "HTTP",
  "agreementConfirmed": true
}
```

## 请求字段

- `requestId` 是当前用户内的幂等标识。
- `entitlementId` 和 `whitelistId` 必须属于当前用户。
- `country`、`quantity` 和 `protocol` 决定本批结果。
- `agreementConfirmed` 表示用户已确认使用约定。

## 数量与协议

- `quantity` 为 1–100，控制台默认 10。
- 协议使用接口当前提供的 HTTP、HTTPS 或 SOCKS5 枚举。
- 地区使用控制台提供的国家或全球值。

## 响应

- 成功返回本次公开网关地址和无登录态 GET 链接。
- 调用方不得依赖结果顺序。
- 提取本身不扣流量，真实代理字节在网关结算。

## 错误处理

- 401 时重新登录。
- 10601 表示需要完成实名认证。
- 白名单、权益或参数错误应修正后再提交。

html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}