लॉगिन दायरा और विकल्प

GET/account/api/v1/extra-logins/options

प्राधिकरण

Authorization	`Bearer YOUR_ARNPROXY_API_KEY`
आवश्यक अनुमति	`proxy_management`
Accept	`application/json`

पैरामीटर

नाम	प्रकार	विवरण
`proxy_ids` queryआवश्यक	`string`	1–1000 अद्वितीय प्रॉक्सी ID, बिना रिक्ति कॉमा से अलग: 12345,12346।

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

cURL

printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    'https://www.arnproxy.com/account/api/v1/extra-logins/options?proxy_ids=YOUR_PROXY_ID'

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

उत्तर

200सफल उत्तर

application/json

{
    "ok": true,
    "data": {
        "proxy_ids": [
            12345
        ],
        "scope_mode": "order_group",
        "group_change_required": true,
        "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "creation_available": true,
        "unavailable_reason": null,
        "custom_credentials_available": false,
        "username_length": 8,
        "password_length": 10,
        "primary_credentials_modified": false,
        "authorization_scope": "upstream_order",
        "may_affect_other_proxies": false
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}

उत्तर के फ़ील्ड और प्रकार

नाम	प्रकार	विवरण
`ok`	`boolean`	सफलता संकेत; false पर error.code देखें।
`data`	`object`	कार्रवाई-विशिष्ट परिणाम; उदाहरण कृत्रिम और समझाने के लिए हैं।
`data.proxy_ids`	`array`	इस खाते को दिखने वाले दायरे की प्रॉक्सी ID।
`data.proxy_ids[]`	`integer`	इस खाते को दिखने वाले दायरे की प्रॉक्सी ID।
`data.scope_mode`	`string`	प्राधिकरण दायरा। ऑर्डर/पैकेज की कार्रवाई अन्य आवंटन प्रभावित कर सकती है।
`data.group_change_required`	`boolean`	group change required का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`data.revision`	`string`	संबंधित बदलाव/मूल्य पुष्टि में अपरिवर्तित लौटाने वाला ताज़गी संकेत।
`data.creation_available`	`boolean`	शर्तों/अनुमतियों के अनुसार उपलब्धता, स्टॉक या प्रदाता की गारंटी नहीं।
`data.unavailable_reason`	`string\|null`	unavailable reason का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`data.custom_credentials_available`	`boolean`	custom credentials available का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`data.username_length`	`integer`	username length का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`data.password_length`	`integer`	password length का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`data.primary_credentials_modified`	`boolean`	primary credentials modified का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`data.authorization_scope`	`string`	प्राधिकरण दायरा। ऑर्डर/पैकेज की कार्रवाई अन्य आवंटन प्रभावित कर सकती है।
`data.may_affect_other_proxies`	`boolean`	पैकेज/ऑर्डर-व्यापी दायरे से अन्य आवंटन प्रभावित हो सकते हैं।
`meta`	`object`	अनुरोध संबद्धता और डेटा-स्रोत मेटाडेटा।
`meta.request_id`	`string`	इस HTTP अनुरोध की पहचान; कार्रवाई कुंजी या ऑर्डर ID नहीं।
`meta.phase`	`string`	phase का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`meta.source`	`string`	डेटा स्रोत; स्थानीय रिकॉर्ड और लाइव प्रदाता क्वेरी अलग प्रमाण हैं।

त्रुटि उत्तर

HTTP 401 · INVALID_API_KEY

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

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

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

अतिरिक्त लॉगिन मुख्य डिलीवरी लॉगिन से अलग हैं। नया लॉगिन बनाने से मुख्य लॉगिन नहीं बदलता और अन्य अतिरिक्त लॉगिन नहीं मिटते। पहले विकल्प उत्तर में custom_credentials_available, username_length और password_length पढ़ें।
कार्रवाई केवल चुने प्रॉक्सी के बजाय पूरे अनुमति समूह, जैसे ऑर्डर या पैकेज, को प्रभावित कर सकती है। आगे बढ़ने से पहले proxy_ids, authorization_scope और may_affect_other_proxies जाँचें। दायरा बदले तो नया revision लें।