jump-once-proxy（跳转一次 Agent）

JumpOnce Proxy

Forward HTTP/WS requests through JumpOnce proxy to access overseas resources.

Setup

Get API Key

1. Register & login at panel.jumptox.top
2. Go to Console → API Keys → Create
3. Copy the key (starts with jk_live_)

Configure

export JUMPONCE_API_KEY="jk_live_xxxxxxxxxxxx"

Or save it in workspace TOOLS.md for persistent access.

Quick Usage

Option A: Python SDK

pip install jump-once

from jump import Client

client = Client(api_key="jk_live_xxxxxxxxxxxx")

# HTTP GET
result = client.http.forward(url="https://example.com/api")
print(result.status_code, result.body)

# HTTP POST
result = client.http.forward(
    url="https://api.example.com/data",
    method="POST",
    body='{"key": "value"}',
    headers={"Content-Type": "application/json"},
)

Option B: Direct API Call

import requests

resp = requests.post(
    "http://api.jumptox.top/api/v1/http/request",
    json={
        "url": "https://example.com/api",
        "method": "GET",
        "headers": {},
        "params": {},
        "timeout": 30,
    },
    headers={"Authorization": "Bearer jk_live_xxxxxxxxxxxx"},
)
print(resp.json())

Option C: Bundled Script

python scripts/forward_request.py --url "https://example.com" --api-key "jk_live_xxx"

Use --raw flag for unparsed response, --body for POST data.

Endpoints

• Structured forward: POST /api/v1/http/request — returns {code, data: {statusCode, headers, body, elapsed}}
• Raw passthrough: POST /api/v1/http/raw — returns target's raw response
• WebSocket: See API Reference for channel management

Limits

• HTTP body: 10 MB | Timeout: 120 s | Redirects: 5
• Allowed ports: 80, 443, 8080, 8443
• WS frame: 1 MB | WS idle: 30 min

Full API docs: references/api-reference.md