SpeakNotes API त्रुटि कोड

प्रत्येक विफलता एक ही JSON लिफाफा लौटाती है: एक स्थिर कोड, एक मानव-पठनीय संदेश, इस पृष्ठ का लिंक, और त्रुटि होने पर संबंधित फील्ड्स।

आकार

त्रुटियाँ कभी भी HTML के रूप में वापस नहीं आती हैं। कोड स्थिर है और उस पर ब्रांच करना सुरक्षित है; संदेश किसी भी समय बदल सकता है।

HTTP/1.1 402 Payment Required
X-Request-Id: 0f0a3f2c-6f1e-4a5e-9f1b-9d0b5a2c7e11

{
  "error": {
    "type": "billing_error",
    "code": "insufficient_credits",
    "message": "This operation costs 14 credits and the account has 3 left.",
    "doc_url": "https://speaknotes.io/developers/errors#insufficient_credits",
    "request_id": "0f0a3f2c-6f1e-4a5e-9f1b-9d0b5a2c7e11"
  }
}

कोड

invalid_request400
The request was malformed or failed validation.
invalid_token401
The credential is missing, malformed, expired, or revoked.
insufficient_scope403
The credential is valid but lacks the scope this operation needs.
not_found404
The requested resource does not exist.
method_not_allowed405
That HTTP method is not supported on this path.
conflict409
The request conflicts with the current state of the resource.
payload_too_large413
The uploaded file exceeds the size limit.
unsupported_media_type415
The file format is not supported.
insufficient_credits402
The account has no credits left for this operation.
rate_limited429
Too many requests. Retry after the interval in the Retry-After header.
upstream_failure502
A provider SpeakNotes depends on failed.
content_policy422
The content was refused by the AI content policy.
internal_error500
SpeakNotes failed to process the request.

क्या दोबारा प्रयास करें

Retry-After में दिए गए अंतराल के बाद rate_limited का पुनः प्रयास करें, और बैकऑफ़ के साथ एक या दो बार upstream_failure का प्रयास करें। invalid_request, insufficient_scope, या content_policy का कभी भी पुनः प्रयास न करें: वे हर बार उसी तरह विफल होंगे।

अनुरोध आईडी

प्रत्येक प्रतिक्रिया में एक X-Request-Id हेडर होता है, और त्रुटि बॉडी इसे दोहराती है। इसे सपोर्ट टीम को बताएं ताकि सटीक विफलता का पता लगाया जा सके।