अधिकृत IP जोड़ें

प्राधिकरण

पैरामीटर

अनुरोध का मुख्य भाग

YOUR_/FROM_ को संबंधित कैटलॉग, कोट या दायरे के मान से बदलें। उदाहरणों में सहमति false है; वास्तविक कार्रवाई केवल जानबूझकर मंज़ूर करें।

{
    "proxy_id": "YOUR_PROXY_ID",
    "ip": "YOUR_PUBLIC_IPV4",
    "expected_revision": "FROM_SCOPE_REVISION",
    "terms": false
}

अनुरोध उदाहरण

printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    --header 'Idempotency-Key: YOUR_SAVED_OPERATION_KEY' \
    --request POST --header 'Content-Type: application/json' \
    --data-binary @request.json \
    'https://www.arnproxy.com/account/api/v1/proxies/authorized-ips/add'

इस पेज पर उदाहरण नहीं चलते। API कुंजी सर्वर की पर्यावरण चर में रखें, URL या ब्राउज़र कोड में नहीं। POST के लिए request.json तैयार करें।

उत्तर

{
    "ok": true,
    "data": {
        "state": "completed",
        "action": "ip_add",
        "proxy_ids": [
            12345
        ],
        "reason_code": null,
        "replayed": false,
        "provider_write_steps_sent": 1,
        "resume_available": false,
        "primary_credentials_locked": true,
        "credentials_returned": false,
        "balance_changed": false,
        "proxy_expiry_changed": false,
        "authorization_scope": "upstream_order",
        "shared_order_effects_accepted": true,
        "grant_state": "active"
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}

त्रुटि उत्तर

{
  "ok": false,
  "error": { "code": "INVALID_API_KEY" },
  "meta": { "request_id": "000000000000000000000001" }
}

प्रमाणीकरण और जाँच निष्पादन से पहले अनुरोध रोक सकते हैं। त्रुटि संदर्भ देखें और सहायता के लिए request_id रखें। कुंजी या पासवर्ड न भेजें। त्रुटियाँ और सीमाएँ →

व्यवहार और महत्वपूर्ण नोट

• कार्रवाई केवल चुने प्रॉक्सी के बजाय पूरे अनुमति समूह, जैसे ऑर्डर या पैकेज, को प्रभावित कर सकती है। आगे बढ़ने से पहले proxy_ids, authorization_scope और may_affect_other_proxies जाँचें। दायरा बदले तो नया revision लें।
• हटाने के लिए इसी खाते का API-जोड़ा अनुदान चाहिए; व्यवस्थापक या दूसरे उपयोगकर्ता का IP नहीं हटता। IP अनुदान अलग समाप्ति जाँच में आते हैं।
• टाइमआउट/5xx लिखने की विफलता का प्रमाण नहीं। मूल Idempotency-Key से स्थिति पूछें। नई कुंजी से न दोहराएँ; GET बदलाव फिर नहीं भेजता।
• मेरा खाता → API की अनुमति सूची तय करती है कि कौन-से IP API कुंजी का उपयोग कर सकते हैं; इसे खाते के पृष्ठ से बदलें। प्रॉक्सी की अधिकृत IP सेटिंग तय करती है कि कौन प्रॉक्सी से जुड़ सकता है। दोनों सेटिंग एक-दूसरे को नहीं बदलतीं।