ದೋಷಗಳು ಮತ್ತು ಪುನರಾವರ್ತನೆಗಳು
ವ್ಯವಹಾರ ದೋಷಗಳು ಪ್ರತಿಕ್ರಿಯೆ ದೇಹದ ಮೇಲ್ಮಟ್ಟದಲ್ಲಿ code ಮತ್ತು message ಅನ್ನು ಹಿಂದಿರುಗಿಸುತ್ತವೆ. detail ಸಾಮಾನ್ಯವಾಗಿ message ನಂತೆಯೇ ಇರುತ್ತದೆ ಆದರೆ ಕೆಳಗಿನಂತೆ ವಿಭಿನ್ನ, ಸಂಕ್ಷಿಪ್ತ ವಿವರಣೆಯಾಗಿರಬಹುದು; ಬಳಕೆದಾರರಿಗೆ message ಅನ್ನು ತೋರಿಸಿ. ಸಂದೇಶಗಳು ಚೀನೀ ಭಾಷೆಯಲ್ಲಿವೆ:
{ "code": "CONCURRENCY_LIMITED", "message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交", "detail": "排队文件完成一部分后可继续提交"}ಕೆಲವು ವ್ಯವಹಾರ ದೋಷಗಳು code ಅನ್ನು ಮಾತ್ರ ಹಿಂದಿರುಗಿಸುತ್ತವೆ. ಪರಿಶೀಲನಾ ವೈಫಲ್ಯಗಳು 422 ಅನ್ನು ಹಿಂದಿರುಗಿಸುತ್ತವೆ, ಜೊತೆಗೆ detail ನಲ್ಲಿ ಕ್ಷೇತ್ರ ದೋಷಗಳ ಪಟ್ಟಿಯನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ:
{ "detail": [ { "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" } ]}HTTP ಸ್ಥಿತಿಯನ್ನು ಮೊದಲು ಪರಿಹರಿಸಿ, ನಂತರ code ಅನ್ನು ಬಳಸಿ: ಅನೇಕ ದೋಷಗಳು ಸಾಮಾನ್ಯ UNKNOWN_ERROR ಅನ್ನು ಮಾತ್ರ ಹಿಂದಿರುಗಿಸುತ್ತವೆ, ಮತ್ತು ಕೆಲವು ಮಾತ್ರ ನಿರ್ದಿಷ್ಟ code ಅನ್ನು ಒಳಗೊಂಡಿರುತ್ತವೆ (ಉದಾಹರಣೆಗೆ ಕೆಳಗಿನ 429 ಪ್ರಕರಣಗಳು). ತೊಂದರೆ ಪರಿಹಾರಕ್ಕಾಗಿ X-Request-Id ಪ್ರತಿಕ್ರಿಯೆ ಶೀರ್ಷಿಕೆಯನ್ನು ದಾಖಲಿಸಿ.
HTTP ಸ್ಥಿತಿ
Section titled “HTTP ಸ್ಥಿತಿ”| ಸ್ಥಿತಿ | ಅರ್ಥ | ಸಲಹೆ |
|---|---|---|
400 | ಅಮಾನ್ಯ ವಿನಂತಿ, ಉದಾಹರಣೆಗೆ ಆಯ್ಕೆ ಮಾಡಲಾದ ಸೆಟ್ಟಿಂಗ್ ಲಭ್ಯವಿಲ್ಲ. | ಅನುರೋಧವನ್ನು ಸರಿಪಡಿಸಿ; ಮರುಪ್ರಯತ್ನ ಮಾಡಬೇಡಿ |
401 | ಅನಧಿಕೃತ ಪ್ರಮಾಣಪತ್ರ, ಅಮಾನ್ಯವಾಗಿದೆ, ಅವಧಿ ಮುಗಿದಿದೆ ಅಥವಾ ರದ್ದುಗೊಳಿಸಲಾಗಿದೆ | ಅನುಮತಿ ಪತ್ರವನ್ನು ಬದಲಾಯಿಸಿ |
402 | ಬಾಕಿ (ಸಾಲ ಕಡಿತದ ನಂತರ) ಉದ್ಯೋಗ ಮಟ್ಟಕ್ಕಿಂತ ಹೆಚ್ಚಿಲ್ಲ ಅಥವಾ ಋಣಾತ್ಮಕವಾಗಿದೆ; API ಕೀಲಿಯೊಂದಿಗೆ, ಕೀಲಿಯ ಉಳಿದ ಬಜೆಟ್ ತುಂಬಾ ಕಡಿಮೆಯಿರಬಹುದು | ಟಾಪ್ ಅಪ್ (ಅಥವಾ ಕೀಲಿಯ ಬಜೆಟ್ ಹೆಚ್ಚಿಸಿ), ನಂತರ ಮತ್ತೊಮ್ಮೆ ಸಲ್ಲಿಸಿ |
403 | ಕೀಲಿಯ ಮಿತಿಗಳು ಈ ಕಾರ್ಯಾಚರಣೆಯನ್ನು ಅನುಮತಿಸುವುದಿಲ್ಲ (ಉದಾಹರಣೆಗೆ, ಅನುವಾದ ಸೆಟ್ಟಿಂಗ್ ಅನುಮತಿಸಲ್ಪಡುವುದಿಲ್ಲ), ಖಾತೆಯನ್ನು ನಿಷ್ಕ್ರಿಯಗೊಳಿಸಲಾಗಿದೆ, ಅಥವಾ ಕಾರ್ಯಾಚರಣೆಯನ್ನು ಸೈನ್-ಇನ್ ಮಾಡಿದ ಬ್ರೌಸರ್ನಲ್ಲಿ ಮಾಡಬೇಕಾಗುತ್ತದೆ (ಉದಾಹರಣೆಗೆ API ಕೀಲಿಗಳನ್ನು ನಿರ್ವಹಿಸುವುದು). | ಕೀ ಸೆಟ್ಟಿಂಗ್ಗಳನ್ನು ಪರಿಶೀಲಿಸಿ ಅಥವಾ ವೆಬ್ಸೈಟ್ ಬಳಸಿ |
404 | ಸಂಪನ್ಮೂಲ ಅಸ್ತಿತ್ವದಲ್ಲಿಲ್ಲ, ಅದನ್ನು ಅಳಿಸಲಾಗಿದೆ ಅಥವಾ ಇದು ಬೇರೆ ಖಾತೆಗೆ ಸೇರಿದೆ (ಈ ಮೂರೂ ಒಂದೇ ರೀತಿ ಕಾಣುತ್ತವೆ) | ID ಅನ್ನು ಪರಿಶೀಲಿಸಿ |
409 | idempotency ಕೀಲಿಯನ್ನು ಬೇರೆ ವಿನಂತಿಗಾಗಿ ಬಳಸಲಾಗಿದೆ, ಅಥವಾ ಸಂಪನ್ಮೂಲದ ಸ್ಥಿತಿ ಕಾರ್ಯಾಚರಣೆಯನ್ನು ಅನುಮತಿಸುವುದಿಲ್ಲ | ಮೂಲ ಕಾರ್ಯಾಚರಣೆಯನ್ನು ಪ್ರಶ್ನಿಸಿ, ನಂತರ ನಿರ್ಧರಿಸಿ |
410 | ಸಂಪನ್ಮೂಲ ಅಥವಾ ಎಂಡ್ಪಾಯಿಂಟ್ ಶಾಶ್ವತವಾಗಿ ಕಣ್ಮರೆಯಾಗಿದೆ, ಉದಾಹರಣೆಗೆ ನಿವೃತ್ತಗೊಂಡ ಎಂಡ್ಪಾಯಿಂಟ್ ಅಥವಾ ಇಡೆಂಪೋಟೆನ್ಸಿ ಕೀಲಿಯ ಹಿಂದೆ ಡಿಲೀಟ್ ಮಾಡಲಾದ ಜಾಬ್ | ಮರುಪ್ರಯತ್ನ ಮಾಡಬೇಡಿ |
413 | ಫೈಲ್ ಅಥವಾ ವಿನಂತಿಯ ದೇಹವು ಮಿತಿಯನ್ನು ಮೀರಿದೆ | ಚಿಕ್ಕ ಫೈಲ್ ಅನ್ನು ಬಳಸಿ |
415 | ಅಸಮರ್ಥಿತ ಫೈಲ್ ಸ್ವರೂಪ | ಬೇರೆ ಫಾರ್ಮ್ಯಾಟ್ ಅನ್ನು ಬಳಸಿ |
422 | ಮಾನ್ಯತೆ ವಿಫಲವಾಗಿದೆ ಅಥವಾ ಫೈಲ್ ಖಾಲಿ ಇದೆ ಅಥವಾ ಪ್ರಕ್ರಿಯೆಗೆ ಯಾವುದೇ ವಸ್ತುವಿಲ್ಲ. | ಕ್ಷೇತ್ರಗಳನ್ನು ಸರಿಪಡಿಸಿ; ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಪುನಃ ಪ್ರಯತ್ನಿಸಬೇಡಿ |
429 | ದರ, ಕ್ಯೂ ಗಾತ್ರ ಅಥವಾ ಬಜೆಟ್ ಸೀಮಿತ | ಕೆಳಗೆ ನೋಡಿ |
5xx | ತಾತ್ಕಾಲಿಕ ಸೇವಾ ದೋಷ | ಗರಿಷ್ಠ ಪ್ರಯತ್ನಗಳ ಸಂಖ್ಯೆಯೊಂದಿಗೆ ಘಾತೀಯ ಹಿಮ್ಮೆಟ್ಟುವಿಕೆ |
429 ಅನ್ನು ನಿರ್ವಹಿಸುವುದು
Section titled “429 ಅನ್ನು ನಿರ್ವಹಿಸುವುದು”code | ಅರ್ಥ | ಏನು ಮಾಡಬೇಕು |
|---|---|---|
RATE_LIMITED | ಅತಿಯಾದ ವಿನಂತಿಗಳು | Retry-After ಕಾಯ್ದಿರಿಸಿ, ನಂತರ ಮತ್ತೆ ಪ್ರಯತ್ನಿಸಿ |
CONCURRENCY_LIMITED | ಹೆಚ್ಚಿನ ಫೈಲ್ ಅನುವಾದ ಕಾರ್ಯಗಳು ಸರತಿಯಲ್ಲಿವೆ | Retry-After ಗಾಗಿ ಕಾಯಿರಿ, ಅಥವಾ ಕೆಲವು ಕೆಲಸಗಳು ಮುಗಿಯುವವರೆಗೆ ಕಾಯಿರಿ |
AUTH_API_KEY_QUOTA_EXCEEDED | ಕೀಲಿಯ ಬಜೆಟ್ ಖರ್ಚಾಗಿದೆ | ಬಜೆಟ್ ಹೆಚ್ಚಾಗುವವರೆಗೆ ಮರುಪ್ರಯತ್ನ ಮಾಡಬೇಡಿ |
Retry-After ಇಲ್ಲದ 429 ಅನ್ನು ಘಾತೀಯ ಹಿಂದೆ ಸರಿಸುವಿಕೆಯೊಂದಿಗೆ ನಿರ್ವಹಿಸಬೇಕು.
ಪ್ರಯತ್ನ ಪುನರಾವರ್ತನೆ ಕಾರ್ಯತಂತ್ರ
Section titled “ಪ್ರಯತ್ನ ಪುನರಾವರ್ತನೆ ಕಾರ್ಯತಂತ್ರ”- ಪ್ರಶ್ನೆಗಳನ್ನು ನೇರವಾಗಿ ಪುನರಾವರ್ತಿಸಬಹುದು.
- ಸೃಷ್ಟಿ ವಿನಂತಿಯನ್ನು ಮರುಪ್ರಯತ್ನಿಸುವಾಗ, ಅದೇ
Idempotency-Keyಮತ್ತು ನಿಖರವಾದ ದೇಹವನ್ನು ಮರುಬಳಕೆ ಮಾಡಿ; ಪ್ರತಿ ಹೊಸ ಸಲ್ಲಿಕೆಗೆ ಹೊಸ ಕೀಲಿಯನ್ನು ಬಳಸಿ. - ಅಪಲೋಡ್ ವಿಫಲವಾದ ನಂತರ, ಹೊಸ ಅಪಲೋಡ್ ವಿಳಾಸವನ್ನು ಕೇಳಿ.
- ಪ್ರತಿ ವಿನಂತಿಗಾಗಿ ಸಂಪರ್ಕ, ಓದುವಿಕೆ ಮತ್ತು ಒಟ್ಟು ನಿರೀಕ್ಷಣಾ ಕಾಲಮಿತಿಗಳನ್ನು ಹೊಂದಿಸಿ, ಪುನರ್ಪ್ರಯತ್ನಗಳಿಗೆ ಯಾದೃಚ್ಛಿಕ ಜಿಟ್ಟರ್ ಅನ್ನು ಸೇರಿಸಿ ಮತ್ತು ಪ್ರಯತ್ನಗಳ ಸಂಖ್ಯೆಗೆ ಮಿತಿ ಹಾಕಿ.
import randomimport time
for attempt in range(5): response = call_api() if response.status_code not in {429, 500, 502, 503, 504}: break if response.status_code == 429 and response.json().get("code") == "AUTH_API_KEY_QUOTA_EXCEEDED": break retry_after = response.headers.get("Retry-After") delay = float(retry_after) if retry_after else min(2 ** attempt, 16) time.sleep(delay + random.random())