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

生成动态连接

选择出口国家,以及轮换或粘性会话。

点击接口可编辑请求并查看响应。

查看可用选项

使用 dynamic:read 读取 GET/dynamic/config。响应包含工作空间支持的国家、协议、会话选项和流量包。

请使用响应中的国家值。仅当配置支持时,使用 "*" 表示所有可用国家。不要用空字符串代替。

选择会话

  • 轮换会话:请求使用轮换的 IP 选择方式。
  • 粘性会话:在支持的时长内保持会话,将 duration_minutes 设为支持的值。

普通连接使用标准流量。优化连接同时使用标准流量和优化流量。生成连接不会购买流量。

生成连接

调用 POST/dynamic/profiles,将 COUNTRY 设为支持的国家值,并保存一个请求标识。以下示例创建直连、轮换的 HTTP 连接:

CONNECTION_REQUEST_KEY=$(uuidgen)

curl --fail-with-body "$MIGO_API_BASE/dynamic/profiles" \
  -H "Authorization: Bearer $MIGO_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $CONNECTION_REQUEST_KEY" \
  -d "{\"country\":\"$COUNTRY\",\"protocol\":\"http\",\"mode\":\"rotating\",\"access_optimized\":false}"

API 地址和密钥设置见开始使用。此操作需要写入访问权限、dynamic:write 和 credentials:read。相同配置会复用已保存的连接。

粘性会话请设置 mode: "sticky" 并传入 duration_minutes。支持优化接入时,可设置 access_optimized: true。

查看和管理连接

GET/dynamic/profiles 返回不含密码的连接列表。通过 GET/dynamic/profiles/{id} 读取已就绪连接的详情,再按连接指南接入。

使用 DELETE/dynamic/profiles/{id} 删除已保存的连接。余额和购买步骤见流量与账单。