FlashProxy API संदर्भ

अपना शेष राशि और योजनाओं की जांच करें, उपयोग पढ़ें, प्रॉक्सी उत्पन्न करें और अपनी स्क्रिप्ट से योजनाओं को बढ़ाएं। प्रत्येक एंडपॉइंट JSON लौटाता है और केवल आपके अपने खाते से डेटा पढ़ता है।

आधार URL: https://www.flashproxy.com

https://www.flashproxy.com/dashboard/api पर अपने डैशबोर्ड में एक API कुंजी बनाएं। पूरी कुंजी केवल एक बार दिखाई जाती है, इसलिए इसे सुरक्षित रूप से संग्रहीत करें।

AI एजेंट का उपयोग कर रहे हैं? इसे एक Markdown फ़ाइल के रूप में दें: https://www.flashproxy.com/api-reference.md। एक OpenAPI 3.1 spec https://www.flashproxy.com/openapi.json पर है।

त्वरित प्रारंभ

अपनी योजनाओं की सूची दें, फिर उत्तर से एक plan_id का उपयोग करें अन्य एंडपॉइंट में।

cURL

curl "https://www.flashproxy.com/api/v1/plans?status=active&limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Python

import requests

response = requests.get(
    "https://www.flashproxy.com/api/v1/plans?status=active&limit=10",
    headers={
        "Authorization": "Bearer fpk_live_YOUR_KEY",
    },
    timeout=30,
)
print(response.json())

Node.js

const response = await fetch("https://www.flashproxy.com/api/v1/plans?status=active&limit=10", {
  headers: {
    "Authorization": "Bearer fpk_live_YOUR_KEY",
  },
});
console.log(await response.json());

प्रमाणीकरण

Authorization हेडर में Bearer fpk_live_… के रूप में, या X-API-Key हेडर में अपनी कुंजी भेजें।

प्रत्येक कुंजी उपयोग पढ़ सकती है। प्रॉक्सी जेनरेट करना और योजनाओं को बढ़ाना प्रत्येक को अपनी अनुमति की आवश्यकता है, जो आप कुंजी बनाते समय चुनते हैं। एक कुंजी को पासवर्ड की तरह मानें और यदि यह लीक हो जाए तो इसे रद्द करें।

कुंजी अनुमतियाँ

अनुमति	अनुमति देता है
usage	उपयोग किया गया डेटा, बचा हुआ डेटा और वर्तमान गति पढ़ें। प्रत्येक कुंजी के पास यह है।
proxies	प्रॉक्सी सूचियाँ जनरेट करें। प्रतिक्रियाओं में आपका प्रॉक्सी उपयोगकर्ता नाम और पासवर्ड शामिल होता है।
extend	योजनाओं को विस्तारित करें। प्रत्येक कॉल आपके खाता शेष से भुगतान किया जाता है।

खाता

वर्तमान कुंजी

GET /api/v1/key

आप जिस कुंजी को कॉल कर रहे हैं, उसे लौटाता है: इसका नाम, उपसर्ग और अनुमतियाँ। उपयोगी जब कोई कॉल 403 FORBIDDEN का उत्तर देता है।

अनुमति: usage

अनुरोध

curl "https://www.flashproxy.com/api/v1/key" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "key_id": "7d1c2b4e-…",
    "name": "Monitoring server",
    "key_prefix": "fpk_live_k3x9q2ma",
    "permissions": [
      "usage",
      "proxies",
      "extend"
    ],
    "created_at": "2026-09-29T12:00:00.000Z",
    "last_used_at": "2026-10-13T12:00:00.000Z"
  }
}

खाता बैलेंस

GET /api/v1/balance

आपका उपलब्ध खाता बैलेंस लौटाता है, जिससे विस्तार का भुगतान किया जाता है।

अनुमति: usage

अनुरोध

curl "https://www.flashproxy.com/api/v1/balance" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "balance_usd": 42.18,
    "balance_cents": 4218,
    "currency": "USD"
  }
}

योजनाओं की सूची

GET /api/v1/plans

आपकी योजनाओं को नवीनतम पहले लौटाता है, उनकी स्थिति, समाप्ति, डेटा कैप और क्या वे gb या दिनों से बढ़ाई गई हैं। कभी प्रॉक्सी क्रेडेंशियल्स नहीं लौटाता।

अनुमति: usage

पैरामीटर

नाम	में	विवरण
status	query	all (डिफ़ॉल्ट), active या expired।
limit	query	कितनी योजनाएं दिखानी हैं, 100 तक। डिफ़ॉल्ट रूप से 50।
offset	query	कितनी योजनाएं छोड़नी हैं, पेजिंग के लिए। डिफ़ॉल्ट रूप से 0।

अनुरोध

curl "https://www.flashproxy.com/api/v1/plans?status=active&limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plans": [
      {
        "plan_id": "YOUR_PLAN_ID",
        "product": "residential",
        "name": "Residential Proxies",
        "status": "active",
        "billed_by": "data",
        "created_at": "2026-09-13T12:00:00.000Z",
        "expires_at": "2027-03-12T12:00:00.000Z",
        "max_bytes": 10737418240,
        "bytes_used": 4294967296,
        "speed_mbps": null,
        "extend_with": "gb"
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

लेनदेन सूचीबद्ध करें

GET /api/v1/transactions

आपके भुगतान, टॉप-अप और बैलेंस खरीद, नवीनतम पहले, बहीखाते के लिए लौटाता है।

अनुमति: usage

पैरामीटर

नाम	में	आवश्यक	विवरण
limit	query		कितने लेन-देन दिखाने हैं, 100 तक। डिफ़ॉल्ट रूप से 50।
offset	query		कितने लेन-देन छोड़ने हैं, पेजिंग के लिए। डिफ़ॉल्ट रूप से 0।

अनुरोध

curl "https://www.flashproxy.com/api/v1/transactions?limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "transactions": [
      {
        "transaction_id": "FP-1791900000000-a1b2c3d4e",
        "type": "PURCHASE",
        "status": "COMPLETED",
        "amount_usd": 29.8,
        "payment_method": "BALANCE",
        "description": "Purchase of 1 item",
        "created_at": "2026-10-11T12:00:00.000Z",
        "completed_at": "2026-10-11T12:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0,
    "currency": "USD"
  }
}
```,## उपयोग

### सभी सक्रिय योजनाओं का उपयोग

`GET /api/v1/usage`

आपके खाते पर प्रत्येक सक्रिय योजना के लिए एक उपयोग रिकॉर्ड लौटाता है।

अनुमति: `usage`

**अनुरोध**

```bash
curl "https://www.flashproxy.com/api/v1/usage" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plans": [
      {
        "plan_id": "YOUR_PLAN_ID",
        "product": "ipv6-datacenter",
        "name": "IPv6 Datacenter Proxies",
        "status": "active",
        "expires_at": "2026-11-01T12:00:00.000Z",
        "usage": {
          "bytes_used": 2639963,
          "max_bytes": null,
          "remaining_bytes": null,
          "percentage_used": null
        },
        "throughput_status": "ok",
        "throughput": {
          "source": "per_minute",
          "current_mbps": 412.5,
          "avg_mbps_5m": 380.1,
          "peak_mbps_1h": 955,
          "sampled_at": "2026-10-13T11:59:15.000Z",
          "data_delay_seconds": 45,
          "limit_mbps": 1000,
          "utilization_pct": 41.25
        },
        "generated_at": "2026-10-13T12:00:00.000Z"
      }
    ]
  }
}

एक योजना का उपयोग

GET /api/v1/plans/{plan_id}/usage

आपकी किसी एक योजना का उपयोग रिकॉर्ड दिखाता है, चाहे उसकी कोई भी स्थिति हो।

अनुमति: usage

पैरामीटर

नाम	में	आवश्यक	विवरण
plan_id	path	आवश्यक	योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है।

अनुरोध

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/usage" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "ipv6-datacenter",
    "name": "IPv6 Datacenter Proxies",
    "status": "active",
    "expires_at": "2026-11-01T12:00:00.000Z",
    "usage": {
      "bytes_used": 2639963,
      "max_bytes": null,
      "remaining_bytes": null,
      "percentage_used": null
    },
    "throughput_status": "ok",
    "throughput": {
      "source": "per_minute",
      "current_mbps": 412.5,
      "avg_mbps_5m": 380.1,
      "peak_mbps_1h": 955,
      "sampled_at": "2026-10-13T11:59:15.000Z",
      "data_delay_seconds": 45,
      "limit_mbps": 1000,
      "utilization_pct": 41.25
    },
    "generated_at": "2026-10-13T12:00:00.000Z"
  }
}

उपयोग इतिहास

GET /api/v1/plans/{plan_id}/usage/history

एक योजना का ट्रैफ़िक और गति समय के साथ दिखाता है, निर्धारित बकेट में (1 घंटे के लिए 1 मिनट से 30 दिन के लिए 4 घंटे), कुल, सफलता दर और शिखर के साथ। टाइमस्टैम्प UTC हैं। ISP, ISP EU, Datacenter, IPv6 और Premium Unlimited योजनाओं के लिए उपलब्ध।

अनुमति: usage

पैरामीटर

नाम	में	आवश्यक	विवरण
plan_id	path	आवश्यक	योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है।
range	query		समय विंडो: 1h, 24h, 7d, 30d। डिफ़ॉल्ट रूप से 24h।

अनुरोध

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/usage/history?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "bucket_seconds": 900,
    "generated_at": "2026-10-13T12:00:00.000Z",
    "totals": {
      "bytes": 3221225472,
      "bytes_up": 214748364.8,
      "bytes_down": 3006477107.2,
      "connections": 48210,
      "success_pct": 99.2,
      "peak_mbps": 412.5,
      "peak_concurrent": 37
    },
    "series": [
      {
        "t": "2026-10-13T11:30:00.000Z",
        "bytes": 41943040,
        "bytes_up": 2097152,
        "bytes_down": 39845888,
        "mbps": 0.37,
        "connections_per_sec": 0.62,
        "concurrent": 12
      },
      {
        "t": "2026-10-13T11:45:00.000Z",
        "bytes": 52428800,
        "bytes_up": 3145728,
        "bytes_down": 49283072,
        "mbps": 0.47,
        "connections_per_sec": 0.71,
        "concurrent": 15
      }
    ]
  }
}

शीर्ष गंतव्य

GET /api/v1/plans/{plan_id}/destinations

एक समय सीमा में किसी योजना के सबसे अधिक कनेक्ट किए गए साइटों को दिखाता है, ट्रैफ़िक, कनेक्शन और प्रति होस्ट सफलता दर के साथ (शीर्ष 100)।

अनुमति: usage

पैरामीटर

नाम	में	आवश्यक	विवरण
plan_id	path	आवश्यक	योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है।
range	query		समय विंडो: 1h, 24h, 7d, 30d। डिफ़ॉल्ट रूप से 24h।

अनुरोध

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/destinations?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "generated_at": "2026-10-13T12:00:00.000Z",
    "destinations": [
      {
        "host": "example.com",
        "bytes_down": 1288490188.8,
        "bytes_up": 107374182.4,
        "connections": 18240,
        "failed": 96,
        "success_pct": 99.5
      }
    ]
  }
}

त्रुटि विश्लेषण

GET /api/v1/plans/{plan_id}/errors

एक समय सीमा में क्या गलत हुआ यह दिखाता है, श्रेणी के अनुसार समूहबद्ध, प्रत्येक के साथ एक पठनीय लेबल और जांचने के लिए सुझाव।

अनुमति: usage

पैरामीटर

नाम	में	आवश्यक	विवरण
plan_id	path	आवश्यक	योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है।
range	query		समय विंडो: 1h, 24h, 7d, 30d। डिफ़ॉल्ट रूप से 24h।

अनुरोध

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/errors?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "generated_at": "2026-10-13T12:00:00.000Z",
    "errors": [
      {
        "category": "timeout",
        "label": "Connection timed out",
        "hint": "The destination did not answer in time. Usually a slow or overloaded target site; retry with a longer client timeout, and check whether one destination dominates.",
        "count": 214
      }
    ]
  }
}
```,## प्रॉक्सी

### योजना स्थान

`GET /api/v1/plans/{plan_id}/locations`

उन देशों को दिखाता है जिन्हें एक योजना country फील्ड के साथ लक्ष्य कर सकती है जब आप प्रॉक्सी बनाते हैं। जब any_country सही है, तो कोई भी दो-अक्षर वाला कोड स्वीकार किया जाता है और कोई सूची नहीं होती।

अनुमति: `usage`

**पैरामीटर**

| नाम | में | आवश्यक | विवरण |
| --- | --- | --- | --- |
| `plan_id` | path | आवश्यक | योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है। |

**अनुरोध**

```bash
curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/locations" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "ipv6-datacenter",
    "any_country": false,
    "countries": [
      {
        "code": "CA",
        "name": "Canada"
      },
      {
        "code": "FR",
        "name": "France"
      },
      {
        "code": "US",
        "name": "United States"
      }
    ]
  }
}

प्रॉक्सी जेनरेट करें

POST /api/v1/plans/{plan_id}/proxies

आपकी किसी सक्रिय योजना के लिए तुरंत उपयोग के लिए तैयार प्रॉक्सी लाइन बनाता है, उसी तरह जैसे डैशबोर्ड जनरेटर करता है।

अनुमति: proxies

पैरामीटर

नाम	में	आवश्यक	विवरण
plan_id	path	आवश्यक	योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है।
count	body		कितनी लाइनें दिखानी हैं, 1 से 1000। डिफ़ॉल्ट रूप से 10।
country	body		लक्ष्य करने के लिए दो-अक्षर वाला देश कोड, उदाहरण के लिए US। किसी भी देश के लिए इसे छोड़ दें।
session	body		प्रत्येक अनुरोध पर एक नया IP के लिए rotating (डिफ़ॉल्ट), या समान IP रखने के लिए sticky।
sticky_minutes	body		एक sticky IP कितने समय के लिए रखा जाता है, 1 से 1000 मिनट। Residential और mobile इसे 120 तक सीमित करते हैं। डिफ़ॉल्ट रूप से 30।
protocol	body		http (डिफ़ॉल्ट) या socks5।
format	body		hostport के लिए host:port:user:pass (डिफ़ॉल्ट), या url के लिए scheme://user:pass@host:port।

अनुरोध

curl -X POST "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/proxies" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":2,"country":"US","session":"sticky","sticky_minutes":30,"protocol":"http","format":"hostport"}'

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "count": 2,
    "protocol": "http",
    "format": "hostport",
    "proxies": [
      "adam.flashproxy.io:8080:USERNAME-country-US-session-k3x9q2ma-time-30:PASSWORD",
      "adam.flashproxy.io:8080:USERNAME-country-US-session-p7d1v8tc-time-30:PASSWORD"
    ]
  }
}

निश्चित IP सूची

GET /api/v1/plans/{plan_id}/ips

योजना के निश्चित IPs को इसके लॉगिन के साथ दिखाता है: Datacenter योजनाओं के लिए लाइव निकास IPs, या Dedicated ISP योजनाओं के लिए किराए पर दिए गए IPs। घूर्णन-गेटवे योजनाएं इसके बजाय Generate proxies का उपयोग करें।

अनुमति: proxies

पैरामीटर

नाम	में	आवश्यक	विवरण
plan_id	path	आवश्यक	योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है।
protocol	query		http (डिफ़ॉल्ट) या socks5। Dedicated ISP v2 योजनाएं केवल http का समर्थन करती हैं।
format	query		hostport के लिए host:port:user:pass (डिफ़ॉल्ट), या url के लिए scheme://user:pass@host:port।
limit	query		10000 तक कितने IPs वापस करने हैं। डिफ़ॉल्ट 1000। total हमेशा पूरी गिनती दिखाता है।

अनुरोध

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/ips?protocol=http&limit=2" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "datacenter",
    "source": "live",
    "protocol": "http",
    "format": "hostport",
    "total": 2048,
    "count": 2,
    "proxies": [
      "203.0.113.10:777:USERNAME:PASSWORD",
      "203.0.113.11:777:USERNAME:PASSWORD"
    ]
  }
}
```,## एक्सटेंशन्स

### एक विस्तार के लिए उद्धरण

`GET /api/v1/plans/{plan_id}/extend/quote`

एक विस्तार की लागत दिखाता है, Extend a plan के समान जांच चलाता है, कुछ भी खरीदे बिना।

अनुमति: `usage`

**पैरामीटर**

| नाम | में | आवश्यक | विवरण |
| --- | --- | --- | --- |
| `plan_id` | path | आवश्यक | योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है। |
| `gb` | query |  | उद्धृत करने के लिए GB, डेटा द्वारा बिल की जाने वाली योजनाओं के लिए। |
| `days` | query |  | उद्धृत करने के लिए दिन, समय द्वारा बिल की जाने वाली योजनाओं के लिए। gb या days भेजें, दोनों नहीं। |

**अनुरोध**

```bash
curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/extend/quote?gb=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "added": {
      "gb": 10
    },
    "price_usd": 35,
    "currency": "USD"
  }
}

एक योजना बढ़ाएँ

POST /api/v1/plans/{plan_id}/extend

आपकी किसी एक योजना में डेटा (GB) या समय (दिन) जोड़ता है और आपके खाते की शेष राशि से भुगतान करता है, डैशबोर्ड के समान मूल्य पर।

अनुमति: extend

पैरामीटर

नाम	में	आवश्यक	विवरण
plan_id	path	आवश्यक	योजना ID, जैसा कि List plans द्वारा plan_id में दिया गया है।
Idempotency-Key	header	आवश्यक	इस विस्तार के लिए एक अद्वितीय स्ट्रिंग। नीचे Idempotency देखें।
gb	body		जोड़ने के लिए GB, डेटा द्वारा बिल की जाने वाली योजनाओं के लिए। 1 से 20,00,000 तक एक पूर्ण संख्या।
days	body		जोड़ने के लिए दिन, समय द्वारा बिल की जाने वाली योजनाओं के लिए: 1 से 365, या Premium Unlimited Residential के लिए 1, 7, 30, 60। gb या days भेजें, दोनों नहीं।

अनुरोध

curl -X POST "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/extend" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY" \
  -H "Idempotency-Key: extend-2026-10-13-001" \
  -H "Content-Type: application/json" \
  -d '{"gb":10}'

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "charged_usd": 35,
    "added": {
      "gb": 10
    },
    "plan": {
      "status": "active",
      "expires_at": "2027-04-11T12:00:00.000Z",
      "max_bytes": 21474836480
    },
    "replayed": false
  }
}
```,## उत्पाद और कीमतें

### उत्पाद और कीमतें

`GET /api/v1/products`

प्रत्येक उत्पाद को इसके प्रति-GB स्तरों के साथ दिखाता है (पूरी राशि उस स्तर की दर पर बिल की जाती है जिसमें वह गिरती है) और इसकी गति-और-दिन कीमतें। एक विशिष्ट योजना की सटीक कीमत के लिए Quote an extension का उपयोग करें।

अनुमति: `usage`

**अनुरोध**

```bash
curl "https://www.flashproxy.com/api/v1/products" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

प्रतिक्रिया · 200

{
  "success": true,
  "data": {
    "products": [
      {
        "product": "datacenter",
        "name": "Datacenter Proxies",
        "billed_by": [
          "data",
          "time"
        ],
        "data_pricing": [
          {
            "up_to_gb": 1,
            "per_gb_usd": 0.7
          },
          {
            "up_to_gb": 5,
            "per_gb_usd": 0.65
          }
        ],
        "time_pricing": [
          {
            "mbps": 10,
            "days": 1,
            "price_usd": 1
          },
          {
            "mbps": 10,
            "days": 30,
            "price_usd": 18
          }
        ]
      }
    ],
    "currency": "USD"
  }
}

इडेमपोटेंसी

किसी योजना को बढ़ाने से आपका बैलेंस खर्च होता है, इसलिए प्रत्येक विस्तार कॉल को Idempotency-Key हेडर की आवश्यकता है।

प्रत्येक एक्सटेंशन के लिए एक नई कुंजी का उपयोग करें जिसे आप खरीदना चाहते हैं: 8 से 128 अक्षर, अंक, - या _।
यदि कोई कॉल समय समाप्त हो जाता है या 5xx त्रुटि लौटाता है, तो इसे समान कुंजी के साथ फिर से भेजें। आपसे अधिकतम एक बार शुल्क लिया जाता है, और एक पूर्ण एक्सटेंशन replayed: true के साथ वापस आता है।
समान कुंजी एक अलग योजना या राशि के साथ 409 IDEMPOTENCY_KEY_REUSED लौटाती है।
जबकि पहली कॉल अभी भी चल रही है, समान कुंजी के साथ दूसरी कॉल 409 REQUEST_IN_PROGRESS लौटाती है।

प्रतिक्रिया फील्ड्स

उपयोग प्रतिक्रिया में प्रत्येक योजना एक ही रिकॉर्ड ले जाती है।

फ़ील्ड	अर्थ
usage.*	bytes_used, max_bytes, remaining_bytes और percentage_used। max_bytes और remaining_bytes डेटा कैप के बिना प्लानों पर null हैं। bytes_used Unlimited Residential पर null है, जिसका बिल समय और गति के आधार पर होता है।
throughput.current_mbps	नवीनतम गति माप: अधिकांश उत्पादों के लिए अंतिम पूर्ण मिनट, जब हाल ही में कोई ट्रैफ़िक नहीं था तो 0।
throughput.avg_mbps_5m / peak_mbps_1h	5-मिनट का औसत और 1-घंटे की शिखर गति।
throughput.limit_mbps	आपके प्लान की गति सीमा। utilization_pct वर्तमान गति को इस सीमा से विभाजित करता है।
throughput.sampled_at	जब नवीनतम माप लिया गया था। data_delay_seconds बताता है कि यह कितना पुराना है।

throughput_status के मान

मान	अर्थ
ok	throughput भरा हुआ है।
pending	गति अभी भी एकत्र की जा रही है। Unlimited Residential के लिए पहला रीडिंग 10 मिनट तक ले सकता है; सामान्य रूप से पोलिंग जारी रखें।
unavailable	गति अस्थायी रूप से उपलब्ध नहीं है। बाद में पुनः प्रयास करें।
not_supported	इस उत्पाद के पास अभी तक गति मेट्रिक्स नहीं हैं। उपयोग काउंटर अभी भी काम करते हैं।

सीमाएँ

प्रति कुंजी प्रति मिनट 60 अनुरोध
एक खाते की सभी कुंजियाँ प्रति मिनट 120 अनुरोधों की सीमा साझा करती हैं।
सीमा से अधिक होने पर आप 429 को Retry-After: 60 हेडर के साथ प्राप्त करते हैं।
Extend कॉल भी प्रति खाते प्रति मिनट 6 बैलेंस खरीद की सीमा की ओर गिनती करते हैं, डैशबोर्ड के साथ साझा किया गया।
गति प्रति मिनट मापी जाती है, इसलिए हर 15 से 30 सेकंड में पोलिंग पर्याप्त है।
उपयोग उत्तर 15 सेकंड पुराने हो सकते हैं और उत्पाद कीमतें 5 मिनट पुरानी हो सकती हैं।

त्रुटियाँ

त्रुटियाँ एक ही आकार साझा करती हैं: success गलत है और error एक कोड और एक पठनीय संदेश रखता है।

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

स्थिति	कोड	अर्थ
400	INVALID_REQUEST	बॉडी या पैरामीटर अमान्य है। संदेश बताता है कि कौन सा।
400	IDEMPOTENCY_KEY_REQUIRED	एक valid Idempotency-Key हेडर के बिना एक extend कॉल।
400	PAYMENT_REFUSED	बैलेंस पेमेंट अस्वीकार कर दिया गया। सहायता से संपर्क करें।
401	UNAUTHORIZED	कुंजी अनुपलब्ध, अमान्य या प्रतिसंहृत है।
402	INSUFFICIENT_BALANCE	इस विस्तार के लिए आपका बैलेंस बहुत कम है। Top up करें और पुनः प्रयास करें।
403	FORBIDDEN	कुंजी के पास इस एंडपॉइंट के लिए आवश्यक अनुमति नहीं है।
404	NOT_FOUND	आपके खाते पर कोई ऐसी योजना नहीं।
409	PLAN_NOT_ACTIVE	Proxies केवल एक सक्रिय प्लान के लिए बनाए जा सकते हैं।
409	PLAN_NOT_READY	प्लान के पास अभी कोई proxy credentials नहीं हैं। थोड़ी देर में फिर से कोशिश करें।
409	IDEMPOTENCY_KEY_REUSED	यह Idempotency-Key पहले से ही एक अलग extension के लिए उपयोग किया गया था।
409	REQUEST_IN_PROGRESS	इस Idempotency-Key के साथ एक extension अभी भी चल रहा है। एक पल में पुनः प्रयास करें।
409	PRICE_MISMATCH	प्रसंस्करण के दौरान कीमत बदल गई। एक नई Idempotency-Key के साथ पुनः प्रयास करें।
422	EXTENSION_NOT_SUPPORTED	इस प्लान को API के माध्यम से विस्तारित नहीं किया जा सकता। इसे डैशबोर्ड में विस्तारित करें।
422	PROXIES_NOT_SUPPORTED	Dedicated प्लान में एक fixed IP list है। इसे डैशबोर्ड से डाउनलोड करें।
422	USAGE_HISTORY_NOT_SUPPORTED	इस उत्पाद का कोई उपयोग इतिहास नहीं है। इसके काउंटर के लिए उपयोग एंडपॉइंट का उपयोग करें।
422	IPS_NOT_SUPPORTED	यह योजना एक घूर्णन गेटवे का उपयोग करती है, निर्धारित IP सूची नहीं। प्रॉक्सी जनरेट करें का उपयोग करें।
422	CUSTOM_PLAN_EXTEND_VIA_SUPPORT	कस्टम योजनाएं केवल सहायता द्वारा विस्तारित की जाती हैं।
429	RATE_LIMITED	बहुत अधिक अनुरोध। Retry-After की प्रतीक्षा करें, फिर पुनः प्रयास करें।
500	INTERNAL_ERROR	अस्थायी त्रुटि। फिर से प्रयास करें।
502	EXTENSION_FAILED	एक्सटेंशन पूरा नहीं हुआ। समान Idempotency-Key के साथ पुनः प्रयास केवल तभी करें जब संदेश में लिखा हो कि कोई शुल्क नहीं लिया गया; अन्यथा सहायता से संपर्क करें।
503	IPS_UNAVAILABLE	IP सूची को अभी लोड नहीं किया जा सका। एक मिनट में पुनः प्रयास करें।