ARNPROXY

अतिरिक्त लॉगिन बदलें

POST/account/api/v1/extra-logins/replace
कार्रवाई की स्पष्ट पुष्टि करें

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

प्राधिकरण

AuthorizationBearer YOUR_ARNPROXY_API_KEY
आवश्यक अनुमतिproxy_management
Acceptapplication/json
Content-Typeapplication/json
Idempotency-Key16–100 अक्षर, अंक, _ या -। एक ही कार्रवाई के लिए मान सहेजकर दोबारा उपयोग करें।

पैरामीटर

नामप्रकारविवरण
Idempotency-Key
headerआवश्यक
string16–100 अक्षर/अंक/_/-। कार्रवाई और स्थिति में समान मान रखें; अलग बॉडी में पुनः उपयोग न करें।
id
bodyआवश्यक
integerइस कार्रवाई के अपने रिकॉर्ड की ID; 1–2147483647। दिखने वाला ऑर्डर नंबर या प्रदाता ID नहीं।
mode
bodyवैकल्पिक
stringrandom (डिफ़ॉल्ट) या 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
{
    "id": "YOUR_EXTRA_LOGIN_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/replace'

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

उत्तर

200सफल उत्तर
application/json
{
    "ok": true,
    "data": {
        "state": "completed",
        "phase": "done",
        "action": "replace_extra_login",
        "old_login_id": 40001,
        "new_login_id": 40002,
        "proxy_ids": [
            12345
        ],
        "reason_code": null,
        "resume_available": false,
        "replayed": false,
        "primary_credentials_modified": false,
        "credentials_included": false,
        "strategy": "create_verify_then_revoke_old"
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}
उत्तर के फ़ील्ड और प्रकार
नामप्रकारविवरण
okbooleanसफलता संकेत; false पर error.code देखें।
dataobjectकार्रवाई-विशिष्ट परिणाम; उदाहरण कृत्रिम और समझाने के लिए हैं।
data.statestringरिकॉर्ड/कार्रवाई स्थिति। accepted डिलीवरी नहीं; completed कनेक्शन परीक्षण नहीं।
data.phasestringphase का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.actionstringaction का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.old_login_idintegerसंबंधित ARNPROXY रिकॉर्ड ID; आंतरिक प्रदाता ID के बदले इसे लें।
data.new_login_idintegerसंबंधित ARNPROXY रिकॉर्ड ID; आंतरिक प्रदाता ID के बदले इसे लें।
data.proxy_idsarrayइस खाते को दिखने वाले दायरे की प्रॉक्सी ID।
data.proxy_ids[]integerइस खाते को दिखने वाले दायरे की प्रॉक्सी ID।
data.reason_codestring|nullनिश्चित कारण कोड या null, मूल प्रदाता त्रुटि पाठ नहीं।
data.resume_availablebooleanन भेजे चरण को स्पष्ट रूप से जारी रखने की सुविधा; false पर स्वतः न दोहराएँ।
data.replayedbooleanउसी कार्रवाई का सहेजा परिणाम लौटा, नए शुल्क/कार्रवाई का प्रमाण नहीं।
data.primary_credentials_modifiedbooleanprimary credentials modified का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.credentials_includedbooleanक्या परिणाम/कुंजी गोपनीय क्रेडेंशियल शामिल या अनुमति देता है।
data.strategystringअतिरिक्त लॉगिन बदलाव में पहले नई पहुँच सत्यापित होती है, फिर पुरानी चुनी पहुँच हटती है।
metaobjectअनुरोध संबद्धता और डेटा-स्रोत मेटाडेटा।
meta.request_idstringइस HTTP अनुरोध की पहचान; कार्रवाई कुंजी या ऑर्डर ID नहीं।
meta.phasestringphase का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
meta.sourcestringडेटा स्रोत; स्थानीय रिकॉर्ड और लाइव प्रदाता क्वेरी अलग प्रमाण हैं।

त्रुटि उत्तर

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 पढ़ें।
  • id अतिरिक्त लॉगिन ID है, प्रॉक्सी ID नहीं। पहले नया लॉगिन सत्यापित होता है, फिर केवल चुना पुराना हटता है। मुख्य प्रॉक्सी तालिका नहीं बदलती।
  • कार्रवाई केवल चुने प्रॉक्सी के बजाय पूरे अनुमति समूह, जैसे ऑर्डर या पैकेज, को प्रभावित कर सकती है। आगे बढ़ने से पहले proxy_ids, authorization_scope और may_affect_other_proxies जाँचें। दायरा बदले तो नया revision लें।
  • टाइमआउट/5xx लिखने की विफलता का प्रमाण नहीं। मूल Idempotency-Key से स्थिति पूछें। नई कुंजी से न दोहराएँ; GET बदलाव फिर नहीं भेजता।
उसी कार्रवाई को ट्रैक करेंलॉगिन बदलाव की स्थिति →

वर्तमान भाषा में खोजें। बंद करें: Esc