एरर

त्रुटियाँ बाकी सब की तरह JSON में होती हैं, उनके अनुरूप HTTP स्टेटस के साथ और एक कोड के साथ जिस पर आप switch कर सकते हैं। संदेश एक वाक्य है जो आपके लॉग के लिए है, आपके उपयोगकर्ताओं के लिए नहीं; उसके शब्द बदल सकते हैं, कोड कभी नहीं बदलेगा।

त्रुटि एनवेलप

{
  "status": "error",
  "error": {
    "code": "invalid_request",
    "message": "Parameter 'lat' must be a number between -90 and 90.",
    "param": "lat"
  }
}

param तब मौजूद होता है जब किसी खास पैरामीटर के कारण समस्या हुई हो। X-Request-Id त्रुटि वाले रिस्पॉन्स पर भी सेट होता है; सपोर्ट से संपर्क करते समय इसे शामिल करें।

कोड

जो चीज़ें त्रुटियाँ नहीं हैं

• कोई परिणाम नहीं। बेमतलब टेक्स्ट का फ़ॉरवर्ड जियोकोड "results": [] के साथ 200 लौटाता है। समुद्र में रिवर्स जियोकोड "result": null के साथ 200 लौटाता है। दोनों एक अनुरोध के रूप में गिने जाते हैं।
• कम सटीकता। जब आप मकान चाहते थे और परिणाम "precision": "admin" के साथ आया, तो यह एक सफल अनुरोध है जिसे उम्मीद से कम मिला। फ़ील्ड की जाँच करें।
• प्राइवेट IP पते। 10.0.0.1 देखने पर "is_private": true और बिना स्थान के 200 मिलता है।

ड्रॉप-इन होस्ट पर त्रुटियाँ

संगतता होस्ट त्रुटियाँ उसी ढाँचे में लौटाते हैं जिसका मूल प्रदाता उपयोग करता है, इसलिए मौजूदा हैंडलिंग काम करती है। उदाहरण के लिए, खाली क्रेडिट बैलेंस gapi.mygeocode.com पर HTTP 200 के साथ "status": "OVER_QUERY_LIMIT" है, bing.mygeocode.com पर Bing एनवेलप में "statusCode": 429 है, और ipapi.mygeocode.com पर {"status":"fail","message":"quota"} है; गलत कुंजी क्रमशः REQUEST_DENIED, 401 और invalid key है। X-Quota-* हेडर हर होस्ट पर हर हाल में भेजे जाते हैं, इसलिए आप चाहें तो हेडर से असली स्थिति पढ़ सकते हैं।

संभालने की एक उचित रणनीति

def call(url, params, tries=3):
    for attempt in range(tries):
        r = session.get(url, params=params, timeout=10)
        if r.status_code == 200:
            return r.json()
        body = r.json()
        code = body["error"]["code"]
        if r.status_code in (500, 503):
            time.sleep(0.2 * (2 ** attempt))
            continue
        # no_credits, key_ip_limit, invalid_request, invalid_key: retrying will not help
        raise ApiError(code, body["error"]["message"], r.headers.get("X-Request-Id"))
    raise ApiError("retries_exhausted", "Gave up after %d attempts" % tries, None)