Session API

Session API 是 NexaLayer 的核心。写操作建议携带 Idempotency-Key。

创建 Session

curl -X POST "https://api.nexalayer.net/v1/sessions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $NEXALAYER_API_KEY" \
  -H "Idempotency-Key: create-session-001" \
  -d '{
    "session_type": "dynamic",
    "product_no": "dynamic_dyn3",
    "quantity": 0.25,
    "protocol": "socks5",
    "rotation_mode": "on_demand"
  }'

Dynamic Session 的 quantity 表示 GB，可以使用小数；Static Session 的 quantity 表示 IP 数量，必须是整数。价格按账号和产品实时计算，请以 /products 使用 IPProxy 汇率换算后的 USD 价格为准。静态 Session 可包含：

{
  "session_type": "static",
  "product_no": "static_us_englewood",
  "quantity": 1,
  "duration": 30,
  "protocol": "socks5",
  "country_code": "US",
  "city_code": "ENGLEWOOD",
  "project_id": "game"
}

查询 Session

curl "https://api.nexalayer.net/v1/sessions/$SID" \
  -H "X-API-Key: $NEXALAYER_API_KEY"

active 状态会返回 proxy.full_url，同时保留 host、port、username、password 兼容字段。

轮换 Dynamic Session

curl -X POST "https://api.nexalayer.net/v1/sessions/$SID/rotate" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $NEXALAYER_API_KEY" \
  -H "Idempotency-Key: rotate-timeout-001" \
  -d '{ "reason": "timeout" }'

支持原因：

manual, scheduled, http_403, http_429, captcha, timeout, block

续费 Static Session

curl -X POST "https://api.nexalayer.net/v1/sessions/$SID/renew" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $NEXALAYER_API_KEY" \
  -H "Idempotency-Key: renew-static-001" \
  -d '{ "duration": 30 }'

终止 Session

curl -X DELETE "https://api.nexalayer.net/v1/sessions/$SID" \
  -H "X-API-Key: $NEXALAYER_API_KEY"

所有脚本都应该在清理步骤终止不再使用的 Session。提前终止只释放底层资源；Session 管理暂时免费，Static 资源提前终止默认不自动退款。