ARNPROXY

पैकेज और टॉपअप का कोट

POST/account/api/v1/residential/quote

प्राधिकरण

AuthorizationBearer YOUR_ARNPROXY_API_KEY
आवश्यक अनुमतिread
Acceptapplication/json
Content-Typeapplication/json

पैरामीटर

नामप्रकारविवरण
mode
bodyआवश्यक
stringnew पैकेज बनाता है; topup अपने पैकेज में GB जोड़ता है।
time_id
bodyआवश्यक
integerसंबंधित कैटलॉग/options की अवधि/GB प्लान ID, दिन या GB की गिनती नहीं।
location_id
bodyसशर्त
integerकेवल mode=new में आवश्यक; topup में वर्जित।
package_id
bodyसशर्त
integerकेवल mode=topup में आवश्यक; new में वर्जित।
promo_code
bodyवैकल्पिक
stringवैकल्पिक प्रमोशन, अधिकतम 100 बाइट। कोट और खरीद/नवीनीकरण में समान रखें।
डिफ़ॉल्ट: ""

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

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

request.json
{
    "mode": "topup",
    "package_id": "YOUR_PACKAGE_ID",
    "time_id": "FROM_RESIDENTIAL_CATALOG",
    "promo_code": ""
}

अतिरिक्त उपयोग उदाहरण

ID और कीमतें उदाहरण मात्र हैं; कैटलॉग और उसी कोट के वास्तविक मान उपयोग करें। JSON ID और expected_total_minor संख्याएँ हों। सुरक्षा के लिए उदाहरणों में terms=false है; वास्तविक भुगतान वाले कार्य के लिए ग्राहक की स्पष्ट सहमति के बाद ही terms=true भेजें।

Residential: नया पैकेज और GB जोड़ना · mode=new

residential_quote और residential_purchase, दोनों में उद्देश्य चुनने की ज़रूरत नहीं। मूल्य अनुरोध में केवल mode, time_id, location_id या package_id और वैकल्पिक promo_code भेजें। खरीद में कोट की मुद्रा, राशि, चयन हैश और स्पष्ट सहमति जोड़ें।

application/json
{
    "mode": "new",
    "location_id": 20,
    "time_id": 201,
    "promo_code": ""
}

Residential: नया पैकेज और GB जोड़ना · mode=topup

residential_quote और residential_purchase, दोनों में उद्देश्य चुनने की ज़रूरत नहीं। मूल्य अनुरोध में केवल mode, time_id, location_id या package_id और वैकल्पिक promo_code भेजें। खरीद में कोट की मुद्रा, राशि, चयन हैश और स्पष्ट सहमति जोड़ें।

application/json
{
    "mode": "topup",
    "package_id": 10001,
    "time_id": 201,
    "promo_code": ""
}

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

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

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

उत्तर

200सफल उत्तर
application/json
{
    "ok": true,
    "data": {
        "mode": "topup",
        "product_id": 33,
        "location_id": 20,
        "time_id": 201,
        "gb": 1,
        "days": 30,
        "package_id": 20001,
        "currency": "TRY",
        "base_total": "15.00",
        "quantity_discount_rate": 0,
        "subtotal": "15.00",
        "promotion": {
            "code": "",
            "rate": 0,
            "amount": "0.00"
        },
        "total": "15.00",
        "total_minor": 1500,
        "last_service_date": "2030-02-01",
        "automatic_renewal": false,
        "stock_checked": false,
        "provider_checked": false,
        "selection_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}
उत्तर के फ़ील्ड और प्रकार
नामप्रकारविवरण
okbooleanसफलता संकेत; false पर error.code देखें।
dataobjectकार्रवाई-विशिष्ट परिणाम; उदाहरण कृत्रिम और समझाने के लिए हैं।
data.modestringmode का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.product_idintegerस्थानीय कैटलॉग स्थान या उत्पाद प्रकार ID।
data.location_idintegerस्थानीय कैटलॉग स्थान या उत्पाद प्रकार ID।
data.time_idintegerस्थानीय अवधि/GB प्लान ID, दिनों या GB की गिनती नहीं।
data.gbintegerट्रैफ़िक मात्रा; सूची/सेटिंग कार्रवाई ट्रैफ़िक नहीं खरीदती।
data.daysintegerप्लान अवधि दिनों में, GB प्लान की ट्रैफ़िक मात्रा से अलग।
data.package_idintegerसंबंधित ARNPROXY रिकॉर्ड ID; आंतरिक प्रदाता ID के बदले इसे लें।
data.currencystringखाते की लेनदेन मुद्रा: TRY या USD।
data.base_totalstringधनराशि; शुद्धता के लिए लौटाया पाठ/पूर्णांक प्रारूप बनाए रखें।
data.quantity_discount_rateintegerquantity discount rate का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.subtotalstringधनराशि; शुद्धता के लिए लौटाया पाठ/पूर्णांक प्रारूप बनाए रखें।
data.promotionobjectpromotion का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.promotion.codestringcode का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.promotion.rateintegerrate का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.promotion.amountstringधनराशि; शुद्धता के लिए लौटाया पाठ/पूर्णांक प्रारूप बनाए रखें।
data.totalstringधनराशि; शुद्धता के लिए लौटाया पाठ/पूर्णांक प्रारूप बनाए रखें।
data.total_minorintegerलघुतम मुद्रा इकाई में पूर्णांक: 1000 = 10.00 TRY/USD।
data.last_service_datestringअंतिम सेवा दिन: मौजूदा, पिछला या अनुमानित। अनुमान से नवीनीकरण नहीं होता।
data.automatic_renewalbooleanautomatic renewal का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें।
data.stock_checkedbooleanकीमत/स्थानीय परिणाम अकेले प्रदाता या स्टॉक की गारंटी नहीं।
data.provider_checkedbooleanकीमत/स्थानीय परिणाम अकेले प्रदाता या स्टॉक की गारंटी नहीं।
data.selection_hashstringसंबंधित बदलाव/मूल्य पुष्टि में अपरिवर्तित लौटाने वाला ताज़गी संकेत।
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 रखें। कुंजी या पासवर्ड न भेजें। त्रुटियाँ और सीमाएँ →

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

  • पैकेज/सूची ID ARNPROXY रिकॉर्ड ID हैं, प्रदाता कुंजियाँ नहीं। पुराना स्नैपशॉट पहुँच नहीं देता; ज़रूरत पर residential_package_refresh लें।
  • mode=new नया पैकेज, mode=topup मौजूदा में GB जोड़ता है। पहले residential_catalog/quote लें। शेष-राशि स्वीकृति और पृष्ठभूमि डिलीवरी अलग हैं; उसी कार्रवाई कुंजी को ट्रैक करें।
  • residential_quote और residential_purchase, दोनों में उद्देश्य चुनने की ज़रूरत नहीं। मूल्य अनुरोध में केवल mode, time_id, location_id या package_id और वैकल्पिक promo_code भेजें। खरीद में कोट की मुद्रा, राशि, चयन हैश और स्पष्ट सहमति जोड़ें।

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