> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/reference/hi/errors-and-status-codes.md).

# त्रुटियाँ और Status Codes

CLI exit codes, SDK exceptions, और REST API error responses के लिए reference।

Roboflow के डेवलपर टूल्स त्रुटि श्रेणियों का एक छोटा सेट साझा करते हैं, जो हर टूल में अलग-अलग तरीके से प्रदर्शित होता है। यह पेज इन सभी के लिए साझा संदर्भ है।

## CLI निकास कोड

CLI चार सुव्यवस्थित निकास कोड का उपयोग करता है ताकि स्क्रिप्ट और AI एजेंट आउटपुट को पार्स किए बिना परिणाम के आधार पर शाखा बना सकें:

| निकास कोड | अर्थ                                                                                                        |
| --------- | ----------------------------------------------------------------------------------------------------------- |
| `0`       | सफलता                                                                                                       |
| `1`       | सामान्य त्रुटि (गलत इनपुट, नेटवर्क विफलता, अप्रत्याशित सर्वर प्रतिक्रिया)                                   |
| `2`       | प्रमाणीकरण विफलता (API कुंजी गायब या अमान्य, कोई workspace चयनित नहीं)                                      |
| `3`       | संसाधन नहीं मिला (project, version, workflow, deployment, आदि मौजूद नहीं है या आपकी key को दिखाई नहीं देता) |

In `--json` मोड में CLI सफलता पर stdout पर संरचित आउटपुट लिखता है और विफलता पर stderr पर JSON त्रुटि ऑब्जेक्ट लिखता है, जिससे stdout खाली रहता है ताकि पाइपलाइनें सुरक्षित रूप से पार्स की जा सकें:

```bash
roboflow --json project get nonexistent 2>error.json
echo $?       # 3
cat error.json
# {"error": {"message": "Project 'nonexistent' not found", "hint": "अपने प्रोजेक्ट देखने के लिए 'roboflow project list' चलाएँ."}}
```

## SDK अपवाद

Python SDK विफलता पर Python अपवाद उठाता है। सबसे सामान्य प्रकार जिनसे आप सामना करेंगे:

| अपवाद                                                | कब                                                                                                                                                               |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `RuntimeError`                                       | ऑपरेशन तार्किक रूप से अमान्य है - जैसे कि `restore()` को ऐसे project पर कॉल करना जो Trash में नहीं है, या ऐसे version पर training करना जो अभी जनरेट नहीं हुआ है। |
| `ValueError`                                         | दिया गया आर्ग्युमेंट गलत रूप में है - जैसे, कोई अपरिचित `model_format` के लिए `Version.download()`.                                                              |
| `roboflow.adapters.rfapi.RoboflowError`              | REST API ने non-2xx प्रतिक्रिया लौटाई। अपवाद की string में सर्वर के त्रुटि body का समावेश होता है।                                                               |
| `roboflow.adapters.deploymentapi.DeploymentApiError` | के समकक्ष `RoboflowError` dedicated-deployments service के लिए।                                                                                                  |
| `requests.exceptions.HTTPError` / `ConnectionError`  | नेटवर्क-स्तरीय विफलताएँ (DNS, TLS, timeout)।                                                                                                                     |

सामान्य नियम: पकड़ें `RuntimeError` तार्किक समस्याओं के लिए, `RoboflowError` सर्वर-साइड अस्वीकृतियों के लिए, और बाकी सबको आगे बढ़ने दें।

```python
from roboflow.adapters import rfapi

try:
    project.restore()
except RuntimeError as e:
    print(f"वापस नहीं ला सकते: {e}")
except rfapi.RoboflowError as e:
    print(f"सर्वर ने अनुरोध अस्वीकार कर दिया: {e}")
```

देखें [लॉगिंग और डिबगिंग](https://docs.roboflow.com/reference/hi/platform/python-sdk/logging-and-debugging.md) यह जानने के लिए कि जब कोई अपवाद पर्याप्त न हो, तो अंतर्निहित HTTP अनुरोध को कैसे निरीक्षण करें।

## REST API स्थिति कोड

REST API मानक HTTP स्थिति कोड का उपयोग करता है। Roboflow-विशिष्ट व्यवहार:

| स्थिति | अर्थ                                                                                                                                                                                                                                                                                                          |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200`  | सफलता। प्रतिक्रिया body JSON है।                                                                                                                                                                                                                                                                              |
| `204`  | सफलता, कोई body नहीं (कुछ के लिए उपयोग किया जाता है `PATCH` / `DELETE` endpoints).                                                                                                                                                                                                                            |
| `400`  | गलत ढंग से निर्मित अनुरोध - आवश्यक फ़ील्ड गायब, गलत संरचना, अमान्य मान।                                                                                                                                                                                                                                       |
| `401`  | प्रमाणीकरण विफलता। या तो कोई `api_key`नहीं है, या वह अमान्य है, या कुंजी के पास ऑपरेशन के लिए आवश्यक scope नहीं है।                                                                                                                                                                                           |
| `402`  | भुगतान आवश्यक। workspace की योजना अनुरोधित ऑपरेशन का समर्थन नहीं करती। inference के लिए, इसका अर्थ है कि model या architecture केवल credit-based plan पर उपलब्ध है, या workspace का मासिक Hosted API inference quota समाप्त हो गया है। प्रतिक्रिया body में एक `AccessException` त्रुटि प्रकार शामिल होता है। |
| `403`  | निषिद्ध। कुंजी ने प्रमाणित किया, लेकिन target workspace या resource तक पहुँच नहीं है।                                                                                                                                                                                                                         |
| `404`  | नहीं मिला। workspace, project, version, workflow, या अन्य resource मौजूद नहीं है (या आपकी key को दिखाई नहीं देता)।                                                                                                                                                                                            |
| `409`  | टकराव। resource ऐसी स्थिति में मौजूद है जो अनुरोधित ऑपरेशन को रोकती है (उदाहरण के लिए, ऐसे version को restore करना जिसका parent project भी Trash में है)।                                                                                                                                                     |
| `423`  | लॉक किया गया। workspace billing रुकी हुई है - कारण के लिए response body देखें।                                                                                                                                                                                                                                |
| `429`  | दर-सीमित। पुनः प्रयास करने से पहले कम से कम `Retry-After` सेकंड प्रतीक्षा करें। `RateLimit-Limit`, `RateLimit-Remaining`और `RateLimit-Reset` (सेकंड) उस bucket का वर्णन करते हैं जिसे आपने hit किया।                                                                                                          |
| `5xx`  | सर्वर त्रुटि। backoff के साथ पुनः प्रयास करना सुरक्षित है।                                                                                                                                                                                                                                                    |

### मानक त्रुटि body

त्रुटियाँ JSON लौटाती हैं जिसमें कम से कम शीर्ष-स्तरीय `error` फ़ील्ड होता है:

```json
{
  "error": "Project 'nonexistent' not found"
}
```

कुछ endpoints में एक `hint` या एक संरचित त्रुटि ऑब्जेक्ट भी शामिल होता है - विवरण के लिए [REST API](https://docs.roboflow.com/reference/hi/platform/rest-api.md) के अंतर्गत प्रति-endpoint दस्तावेज़ देखें।

### Training read दर सीमाएँ

training read endpoints (`GET /:workspace/:project/:version/v2/trainings`, `.../v2/trainings/get`और `.../v2/trainings/recipe`) अनुरोधों की गिनती प्रति API key और प्रति workspace करते हैं। उसी IP address से आने वाला अन्य ट्रैफ़िक आपके खिलाफ नहीं गिना जाता। थ्रॉटल किया गया अनुरोध लौटाता है `429` के साथ `Retry-After` header और यह body:

```json
{
  "error": {
    "code": "training_read_rate_limit_exceeded",
    "message": "Too many training read requests. Please retry later."
  }
}
```

गायब या अमान्य API key वाले दोहराए गए अनुरोधों पर अलग से, IP address के आधार पर, सीमा लगाई जाती है। वे लौटाते हैं `429` सादा text body और वही `Retry-After` और `RateLimit-*` headers.

### आवश्यक scopes

API keys में प्रति-resource scopes होते हैं। किसी write operation पर 401 अक्सर इसका मतलब होता है कि key के पास संबंधित `*:update` या `*:write` scope नहीं है, भले ही वह resource पढ़ सकती हो। देखें [Advanced API Keys](https://docs.roboflow.com/reference/hi/authentication/authentication/scoped-api-keys.md) scope संदर्भ के लिए।

## टूलों के बीच त्रुटि मैपिंग

| स्थिति                                | CLI exit | SDK                                      | REST  |
| ------------------------------------- | -------- | ---------------------------------------- | ----- |
| गायब / अमान्य API key                 | `2`      | `RoboflowError` ("401")                  | `401` |
| संसाधन नहीं मिला                      | `3`      | `RoboflowError` ("404") / `RuntimeError` | `404` |
| योजना सीमा / quota समाप्त             | `1`      | `RoboflowError` ("402")                  | `402` |
| गलत इनपुट / गलत ढंग से निर्मित अनुरोध | `1`      | `ValueError` / `RoboflowError` ("400")   | `400` |
| सर्वर त्रुटि / अस्थायी                | `1`      | `RoboflowError` ("5xx")                  | `5xx` |

रीट्राई सेटअप करते समय इस तालिका का उपयोग करें: एक `2` / 401 को कभी भी स्वचालित रूप से पुनः प्रयास नहीं करना चाहिए (कुंजी अधिक मान्य नहीं होगी), एक `3` / 404 को कभी भी पुनः प्रयास नहीं करना चाहिए, लेकिन एक `1` 5xx प्रतिक्रिया से प्राप्त त्रुटि बैकऑफ के साथ पुनः प्रयास के लिए उपयुक्त उम्मीदवार है।
