Skip to main content

​
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_ipweb",
    "quantity": 0.25,
    "protocol": "socks5",
    "rotation_mode": "on_demand"
  }'
Dynamic Session 的 quantity 表示 GB，可以使用小数；当前价格为 4/GB。StaticSession的‘quantity‘表示IP数量，必须是整数，最低4 / GB。Static Session 的 `quantity` 表示 IP 数量，必须是整数，最低 10 / 月。 静态 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 资源提前终止默认不自动退款。