अतिरिक्त लॉगिन बनाएँ

POST/account/api/v1/extra-logins/create

कार्रवाई की स्पष्ट पुष्टि करें

यह कार्रवाई रिकॉर्ड, शेष राशि या सेवा सेटिंग बदल सकती है। पहले दायरा और नोट पढ़ें। परिणाम अनिश्चित हो तो नई कार्रवाई के बजाय उसी की स्थिति पूछें।

प्राधिकरण

Authorization	`Bearer YOUR_ARNPROXY_API_KEY`
आवश्यक अनुमति	`proxy_management`
Accept	`application/json`
Content-Type	`application/json`
Idempotency-Key	16–100 अक्षर, अंक, _ या -। एक ही कार्रवाई के लिए मान सहेजकर दोबारा उपयोग करें।

पैरामीटर

नाम	प्रकार	विवरण
`Idempotency-Key` headerआवश्यक	`string`	16–100 अक्षर/अंक/_/-। कार्रवाई और स्थिति में समान मान रखें; अलग बॉडी में पुनः उपयोग न करें।
`proxy_ids` bodyआवश्यक	`integer[]`	1–1000 अपने अद्वितीय प्रॉक्सी ID; साझा दायरा/कीमत चाहिए तो उत्पाद प्रकार न मिलाएँ। कुछ कार्रवाइयों की सीमा कम है।
`mode` bodyवैकल्पिक	`string`	random (डिफ़ॉल्ट) या custom। custom केवल तभी जब विकल्प उत्तर में custom_credentials_available=true हो। आवश्यक लंबाई username_length और password_length में देखें। डिफ़ॉल्ट: `"random"`
`expected_revision` bodyआवश्यक	`string`	इस कार्रवाई की दायरा/सेटिंग क्वेरी का revision: 64 छोटे हेक्स अक्षर।
`terms` bodyआवश्यक	`boolean`	स्पष्ट स्वीकृति के लिए JSON बूलियन true चाहिए, "true" स्ट्रिंग नहीं।
`username` bodyसशर्त	`string`	केवल समर्थित mode=custom में: ठीक 12 ASCII अक्षर या अंक। random मोड में न भेजें।
`password` bodyसशर्त	`string`	केवल समर्थित mode=custom में: ठीक 12 ASCII अक्षर या अंक। random मोड में न भेजें।

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

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

request.json

{
    "proxy_ids": [
        "YOUR_PROXY_ID"
    ],
    "mode": "random",
    "expected_revision": "FROM_SCOPE_REVISION",
    "terms": false
}

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

cURL

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/extra-logins/create'

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

उत्तर

200सफल उत्तर

application/json

{
    "ok": true,
    "data": {
        "state": "completed",
        "action": "create",
        "login_id": 40001,
        "proxy_ids": [
            12345
        ],
        "reason_code": null,
        "resume_available": false,
        "replayed": false,
        "credentials_included": false,
        "primary_credentials_modified": false
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}

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

नाम	प्रकार	विवरण
`ok`	`boolean`	सफलता संकेत; false पर error.code देखें।
`data`	`object`	कार्रवाई-विशिष्ट परिणाम; उदाहरण कृत्रिम और समझाने के लिए हैं।
`data.state`	`string`	रिकॉर्ड/कार्रवाई स्थिति। accepted डिलीवरी नहीं; completed कनेक्शन परीक्षण नहीं।
`data.action`	`string`	action का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`data.login_id`	`integer`	संबंधित ARNPROXY रिकॉर्ड ID; आंतरिक प्रदाता ID के बदले इसे लें।
`data.proxy_ids`	`array`	इस खाते को दिखने वाले दायरे की प्रॉक्सी ID।
`data.proxy_ids[]`	`integer`	इस खाते को दिखने वाले दायरे की प्रॉक्सी ID।
`data.reason_code`	`string\|null`	निश्चित कारण कोड या null, मूल प्रदाता त्रुटि पाठ नहीं।
`data.resume_available`	`boolean`	न भेजे चरण को स्पष्ट रूप से जारी रखने की सुविधा; false पर स्वतः न दोहराएँ।
`data.replayed`	`boolean`	उसी कार्रवाई का सहेजा परिणाम लौटा, नए शुल्क/कार्रवाई का प्रमाण नहीं।
`data.credentials_included`	`boolean`	क्या परिणाम/कुंजी गोपनीय क्रेडेंशियल शामिल या अनुमति देता है।
`data.primary_credentials_modified`	`boolean`	primary credentials modified का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
`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 लें।
टाइमआउट/5xx लिखने की विफलता का प्रमाण नहीं। मूल Idempotency-Key से स्थिति पूछें। नई कुंजी से न दोहराएँ; GET बदलाव फिर नहीं भेजता।

उसी कार्रवाई को ट्रैक करेंलॉगिन कार्रवाई जाँचें →