सामान्य API त्रुटियाँ

यह लेख आपको EKB के क्लाउड प्लेटफ़ॉर्म का उपयोग करते समय सामना आने वाली सबसे सामान्य API त्रुटियों को समझने में सहायता करेगा। आपको विभिन्न HTTP स्थिति कोड और विशिष्ट त्रुटि कोड का विवरण मिलेगा, जो इन समस्याओं को प्रभावी ढंग से हल करने के लिए आवश्यक ट्रबलशूटिंग चरण प्रदान करता है। त्रुटि प्रतिक्रिया प्रारूप और API उपयोग से जुड़ी सामान्य समस्याओं को समझकर, आप त्रुटियों को बेहतर ढंग से संभालने और अपने विकास अनुभव को बेहतर बनाने के लिए बेहतर ढंग से सुसज्जित होंगे।

त्रुटि प्रतिक्रिया प्रारूप

सभी API त्रुटियाँ एक सुसंगत प्रारूप का पालन करती हैं:

{
  "status_code": 400,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message"
  },
  "detail": "Additional error details (optional)"
}

कुछ त्रुटियों में शामिल हो सकते हैं:

• error_id: त्रुटि को ट्रैक करने के लिए अद्वितीय पहचानकर्ता
• invalid_fields: उन फ़ील्ड की सूची जो सत्यापन में विफल रहे (सत्यापन त्रुटियों के लिए)

HTTP स्थिति कोड

400 खराब अनुरोध

अमान्य इनपुट या विकृत अनुरोधों के कारण क्लाइंट-साइड त्रुटियाँ।

VALIDATION_ERROR

त्रुटि कोड: VALIDATION_ERROR स्थिति कोड: 400

विवरण: अनुरोध सत्यापन विफल रहा। अनुरोध में एक या अधिक फ़ील्ड अमान्य हैं।

सामान्य कारण:

• आवश्यक फ़ील्ड गायब हैं
• अमान्य फ़ील्ड प्रारूप (उदा., अमान्य ईमेल, तिथि प्रारूप)
• फ़ील्ड मान अनुमत सीमा से बाहर हैं
• अमान्य डेटा प्रकार

उदाहरण प्रतिक्रिया:

{
  "status_code": 400,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input data",
    "invalid_fields": ["email", "project_id"]
  }
}

ट्रबलशूटिंग:

1. समस्याग्रस्त फ़ील्ड की पहचान करने के लिए invalid_fields एरे की समीक्षा करें
2. API दस्तावेज़ में फ़ील्ड आवश्यकताओं की जाँच करें
3. सत्यापित करें कि डेटा प्रकार अपेक्षित प्रारूपों से मेल खाते हैं
4. सुनिश्चित करें कि सभी आवश्यक फ़ील्ड प्रदान किए गए हैं

INVALID_API_KEY

त्रुटि कोड: INVALID_API_KEY
स्थिति कोड: 400

विवरण: प्रदान किया गया API कुंजी अमान्य या विकृत है।

ट्रबलशूटिंग:

1. सत्यापित करें कि API कुंजी सही ढंग से कॉपी की गई है (कोई अतिरिक्त स्थान नहीं)
2. जाँचें कि क्या API कुंजी मेरा खाता > API कुंजियाँ में सक्रिय है
3. सुनिश्चित करें कि आप अपने वातावरण के लिए सही API कुंजी का उपयोग कर रहे हैं
4. आवश्यकता होने पर API कुंजी पुनर्जनित करें

INVALID_CREDENTIALS

त्रुटि कोड: INVALID_CREDENTIALS
स्थिति कोड: 400

विवरण: प्रमाणीकरण प्रमाणपत्र अमान्य हैं।

ट्रबलशूटिंग:

1. सत्यापित करें कि ईमेल और पासवर्ड सही हैं
2. जाँचें कि क्या खाता लॉक या अक्षम है
3. अपना पासवर्ड रीसेट करने का प्रयास करें
4. सुनिश्चित करें कि आप सही प्रमाणीकरण विधि का उपयोग कर रहे हैं

INVALID_OR_EXPIRED_JWT_TOKEN

त्रुटि कोड: INVALID_OR_EXPIRED_JWT_TOKEN
स्थिति कोड: 400

विवरण: JWT टोकन अमान्य, समाप्त, या विकृत है।

ट्रबलशूटिंग:

1. अपना प्रमाणीकरण टोकन रीफ़्रेश करें
2. लॉग आउट करें और फिर से लॉग इन करें
3. टोकन समाप्ति समय की जाँच करें
4. सत्यापित करें कि टोकन सही हेडर प्रारूप में भेजा जा रहा है

401 अनधिकृत

प्रमाणीकरण आवश्यक है या प्रमाणीकरण विफल रहा।

AUTHENTICATION

त्रुटि कोड: AUTHENTICATION
स्थिति कोड: 401

विवरण: इस संसाधन तक पहुँचने के लिए प्रमाणीकरण आवश्यक है।

ट्रबलशूटिंग:

1. सुनिश्चित करें कि आप लॉग इन हैं
2. जाँचें कि क्या आपका सत्र समाप्त हो गया है
3. सत्यापित करें कि अनुरोध में प्रमाणीकरण हेडर शामिल हैं
4. आवश्यकता होने पर पुनः प्रमाणीकरण करें

INVALID_BEARER_TOKEN

त्रुटि कोड: INVALID_BEARER_TOKEN
स्थिति कोड: 401

विवरण: प्रदान किया गया Bearer टोकन अमान्य है।

ट्रबलशूटिंग:

1. टोकन प्रारूप सत्यापित करें: Bearer <token>
2. जाँचें कि क्या टोकन समाप्त हो गया है
3. प्रमाणीकरण टोकन पुनर्जनित करें
4. सुनिश्चित करें कि टोकन निरस्त नहीं है

EMAIL_IS_NOT_VERIFIED

त्रुटि कोड: EMAIL_IS_NOT_VERIFIED
स्थिति कोड: 401

विवरण: ईमेल पता सत्यापित नहीं किया गया है।

ट्रबलशूटिंग:

1. सत्यापन लिंक के लिए अपना ईमेल जाँचें
2. एक नया सत्यापन ईमेल अनुरोध करें
3. सत्यापित करें कि ईमेल पता सही है
4. स्पैम/जंक फ़ोल्डर की जाँच करें

403 निषिद्ध

अपर्याप्त अनुमतियों के कारण पहुँच अस्वीकृत।

AUTHORIZATION

त्रुटि कोड: AUTHORIZATION
स्थिति कोड: 403

विवरण: इस क्रिया को करने की अनुमति नहीं है।

ट्रबलशूटिंग:

1. सत्यापित करें कि आपके पास आवश्यक भूमिका/अनुमतियाँ हैं
2. जाँचें कि क्या आप परियोजना/टीम के सदस्य हैं
3. पहुँच प्रदान करने के लिए परियोजना/टीम प्रशासक से संपर्क करें
4. सुनिश्चित करें कि आप सही संसाधन तक पहुँच रहे हैं

PERMISSION_DENIED

त्रुटि कोड: PERMISSION_DENIED
स्थिति कोड: 403

विवरण: अनुरोधित संचालन के लिए अनुमति अस्वीकृत।

ट्रबलशूटिंग:

1. अपनी उपयोगकर्ता भूमिका और अनुमतियों की समीक्षा करें
2. परियोजना/टीम पहुँच सेटिंग्स की जाँच करें
3. संसाधन स्वामित्व सत्यापित करें
4. पहुँच के लिए प्रशासक से संपर्क करें

DOMAIN_NOT_ALLOWED

त्रुटि कोड: DOMAIN_NOT_ALLOWED
स्थिति कोड: 403

विवरण: इस संचालन के लिए आपका ईमेल डोमेन अनुमत नहीं है।

ट्रबलशूटिंग:

1. सत्यापित करें कि आपका ईमेल डोमेन व्हाइटलिस्ट में है
2. अपना डोमेन जोड़ने के लिए प्रशासक से संपर्क करें
3. एक अनुमत ईमेल पते का उपयोग करें

404 नहीं मिला

अनुरोधित संसाधन मौजूद नहीं है।

ENTITY_NOT_FOUND

त्रुटि कोड: ENTITY_NOT_FOUND
स्थिति कोड: 404

विवरण: अनुरोधित संसाधन नहीं मिला।

सामान्य परिदृश्य:

• परियोजना नहीं मिली
• एजेंट नहीं मिला
• दस्तावेज़ नहीं मिला
• उपयोगकर्ता नहीं मिला

ट्रबलशूटिंग:

1. सत्यापित करें कि संसाधन ID सही है
2. जाँचें कि क्या संसाधन हटा दिया गया था
3. सुनिश्चित करें कि आपके पास संसाधन तक पहुँच है
4. सत्यापित करें कि आप सही परियोजना/कार्यक्षेत्र का उपयोग कर रहे हैं

FILE_NOT_FOUND

त्रुटि कोड: FILE_NOT_FOUND
स्थिति कोड: 404

विवरण: अनुरोधित फ़ाइल मौजूद नहीं है।

ट्रबलशूटिंग:

1. सत्यापित करें कि फ़ाइल ID या पथ सही है
2. जाँचें कि क्या फ़ाइल हटा दी गई थी
3. सुनिश्चित करें कि फ़ाइल अपेक्षित स्थान पर है
4. फ़ाइल अनुमतियाँ सत्यापित करें

FLOW_NOT_FOUND

त्रुटि कोड: FLOW_NOT_FOUND
स्थिति कोड: 404

विवरण: अनुरोधित वर्कफ़्लो/फ़्लो नहीं मिला।

ट्रबलशूटिंग:

1. सत्यापित करें कि फ़्लो ID सही है
2. जाँचें कि क्या फ़्लो हटा दिया गया था
3. सुनिश्चित करें कि आपके पास फ़्लो तक पहुँच है
4. सत्यापित करें कि फ़्लो वर्तमान परियोजना में मौजूद है

CONFIG_NOT_FOUND

त्रुटि कोड: CONFIG_NOT_FOUND
स्थिति कोड: 404

विवरण: आवश्यक कॉन्फ़िगरेशन नहीं मिला।

ट्रबलशूटिंग:

1. सत्यापित करें कि कॉन्फ़िगरेशन मौजूद है
2. सेटिंग्स में कॉन्फ़िगरेशन सेटअप की जाँच करें
3. सुनिश्चित करें कि आवश्यक सेवाएँ कॉन्फ़िगर हैं
4. कॉन्फ़िगरेशन दस्तावेज़ की समीक्षा करें

500 आंतरिक सर्वर त्रुटि

जाँच की आवश्यकता वाली सर्वर-साइड त्रुटियाँ।

ENGINE_OPERATION_FAILURE

त्रुटि कोड: ENGINE_OPERATION_FAILURE
स्थिति कोड: 500

विवरण: एक आंतरिक इंजन संचालन विफल रहा।

ट्रबलशूटिंग:

1. कुछ क्षण बाद अनुरोध पुनः प्रयास करें
2. status.getodin.ai पर सिस्टम स्थिति की जाँच करें
3. यदि बना रहता है, तो त्रुटि विवरण के साथ सहायता से संपर्क करें
4. उपलब्ध होने पर त्रुटि ID प्रदान करें

EXTERNAL_SERVICE

त्रुटि कोड: EXTERNAL_SERVICE
स्थिति कोड: 500

विवरण: इस संचालन के लिए आवश्यक एक बाहरी सेवा विफल रही।

सामान्य परिदृश्य:

• LLM प्रदाता API विफलता
• तृतीय-पक्ष एकीकरण विफलता (Google Drive, Slack, आदि)
• बाहरी API टाइमआउट

ट्रबलशूटिंग:

1. बाहरी सेवा स्थिति की जाँच करें
2. बाहरी सेवाओं के लिए API कुंजियाँ/प्रमाणपत्र सत्यापित करें
3. अनुरोध पुनः प्रयास करें
4. एकीकरण कॉन्फ़िगरेशन की जाँच करें
5. समस्या बने रहने पर सहायता से संपर्क करें

INFRASTRUCTURE

त्रुटि कोड: INFRASTRUCTURE
स्थिति कोड: 500

विवरण: बुनियादी ढाँचा त्रुटि (डेटाबेस, स्टोरेज, आदि)।

ट्रबलशूटिंग:

1. अनुरोध पुनः प्रयास करें
2. सिस्टम स्थिति की जाँच करें
3. यदि बना रहता है, तो सहायता से संपर्क करें
4. त्रुटि विवरण और टाइमस्टैम्प प्रदान करें

OPEN_AI_FAILED

त्रुटि कोड: OPEN_AI_FAILED
स्थिति कोड: 500

विवरण: OpenAI API कॉल विफल रहा।

ट्रबलशूटिंग:

1. OpenAI सेवा स्थिति की जाँच करें
2. सत्यापित करें कि API कुंजी मान्य है और उसमें क्रेडिट हैं
3. दर सीमाओं की जाँच करें
4. एक्स्पोनेंशियल बैकऑफ़ के साथ पुनः प्रयास करें
5. मॉडल उपलब्धता सत्यापित करें

503 सेवा उपलब्ध नहीं

सेवा अस्थायी रूप से उपलब्ध नहीं है।

EXECUTION_TIMEOUT

त्रुटि कोड: EXECUTION_TIMEOUT
स्थिति कोड: 503

विवरण: संचालन का समय समाप्त हो गया।

ट्रबलशूटिंग:

1. अनुरोध पुनः प्रयास करें
2. यदि संभव हो तो संचालन को सरल बनाएँ
3. जाँचें कि क्या सिस्टम भारी भार पर है
4. बड़े संचालन को छोटे में तोड़ें
5. टाइमआउट बने रहने पर सहायता से संपर्क करें

व्यावसायिक तर्क त्रुटियाँ

QUOTA_EXCEEDED

त्रुटि कोड: QUOTA_EXCEEDED
स्थिति कोड: 400 या 429

विवरण: आपने अपनी कोटा सीमा पार कर दी है।

ट्रबलशूटिंग:

1. मेरा खाता > डैशबोर्ड में अपना वर्तमान उपयोग जाँचें
2. सदस्यता सीमाओं की समीक्षा करें
3. आवश्यकता होने पर अपनी योजना अपग्रेड करें
4. कोटा रीसेट अवधि की प्रतीक्षा करें
5. कोटा वृद्धि के लिए बिक्री से संपर्क करें

FEATURE_DISABLED

त्रुटि कोड: FEATURE_DISABLED
स्थिति कोड: 400

विवरण: यह सुविधा आपके खाते के लिए अक्षम है।

ट्रबलशूटिंग:

1. अपनी सदस्यता योजना की जाँच करें
2. सुविधा उपलब्धता सत्यापित करें
3. यदि सुविधा को उच्चतर स्तर की आवश्यकता है तो योजना अपग्रेड करें
4. सुविधा पहुँच के लिए सहायता से संपर्क करें

FLOW_IN_USE

त्रुटि कोड: FLOW_IN_USE
स्थिति कोड: 400

विवरण: वर्कफ़्लो वर्तमान में उपयोग में है और इसे संशोधित नहीं किया जा सकता।

ट्रबलशूटिंग:

1. सक्रिय निष्पादन पूरा होने की प्रतीक्षा करें
2. सक्रिय वर्कफ़्लो रन रद्द करें
3. वर्कफ़्लो निष्पादन स्थिति की जाँच करें
4. निष्पादन पूरा होने के बाद पुनः प्रयास करें

EXISTING_USER

त्रुटि कोड: EXISTING_USER
स्थिति कोड: 400

विवरण: इस ईमेल वाला उपयोगकर्ता पहले से मौजूद है।

ट्रबलशूटिंग:

1. साइन अप करने के बजाय लॉग इन करने का प्रयास करें
2. यदि आप प्रमाणपत्र भूल गए हैं तो पासवर्ड रीसेट का उपयोग करें
3. एक अलग ईमेल पते का उपयोग करें
4. खाता रिकवरी की आवश्यकता होने पर सहायता से संपर्क करें

एकीकरण-विशिष्ट त्रुटियाँ

INVALID_APP_CONNECTION

त्रुटि कोड: INVALID_APP_CONNECTION
स्थिति कोड: 400

विवरण: अमान्य या समाप्त ऐप कनेक्शन (OAuth एकीकरण)।

ट्रबलशूटिंग:

1. एकीकरण को पुनः प्रमाणीकृत करें
2. OAuth टोकन समाप्ति की जाँच करें
3. एकीकरण प्रमाणपत्र सत्यापित करें
4. सेटिंग्स में एकीकरण पुनः कनेक्ट करें

INVALID_SAML_RESPONSE

त्रुटि कोड: INVALID_SAML_RESPONSE
स्थिति कोड: 400

विवरण: SSO प्रदाता से अमान्य SAML प्रतिक्रिया।

ट्रबलशूटिंग:

1. SSO कॉन्फ़िगरेशन सत्यापित करें
2. SAML मेटाडेटा URL की जाँच करें
3. सुनिश्चित करें कि SSO प्रदाता सुलभ है
4. SSO कॉन्फ़िगरेशन समीक्षा के लिए सहायता से संपर्क करें

RATE_LIMITED

त्रुटि कोड: RATE_LIMITED या ratelimited
स्थिति कोड: 429

विवरण: API दर सीमा पार हो गई।

ट्रबलशूटिंग:

1. दर सीमा विंडो रीसेट होने की प्रतीक्षा करें
2. एक्स्पोनेंशियल बैकऑफ़ लागू करें
3. अनुरोध आवृत्ति कम करें
4. प्रतिक्रिया में दर सीमा हेडर की जाँच करें
5. उच्च दर सीमाओं के लिए योजना अपग्रेड करें

सहायता प्राप्त करना

यदि आपको यहाँ सूचीबद्ध न की गई कोई त्रुटि मिलती है या सहायता की आवश्यकता है:

1. त्रुटि विवरण जाँचें: त्रुटि कोड, संदेश और error_id नोट करें
2. सिस्टम स्थिति जाँचें: ज्ञात मुद्दों के लिए status.getodin.ai पर जाएँ
3. दस्तावेज़ की समीक्षा करें: संबंधित API दस्तावेज़ देखें
4. सहायता से संपर्क करें: इनके साथ सहायता को ईमेल करें:
   • त्रुटि कोड और संदेश
   • त्रुटि ID (यदि उपलब्ध हो)
   • पुनरुत्पादन के चरण
   • अनुरोध/प्रतिक्रिया विवरण (सैनिटाइज़ किए गए)
   • त्रुटि का टाइमस्टैम्प