Сұрауды тексеру кезінде анықталған қателер OpenAI SDK-мен үйлесімді форматта қайтарылады:
JSON
{
"error": {
"type": "permission_error",
"code": "module_not_allowed",
"message": "The token does not grant access to the module ACADEMIC.",
"request_id": "6f1c2a9e-4b7d-4e0a-9c55-2d8e1f3b7a10"
}
}error объектісінің өрістері:
type— қате санаты:authentication_error(401),permission_error(403),not_found_error(404),invalid_request_error(400, 405, 413),rate_limit_error(429),api_error(5xx);code— қатенің машинамен оқылатын коды;message— қатенің ағылшын тіліндегі сипаттамасы;request_id— университетке жүгінген кезде көрсетілетін сұрау идентификаторы.
9.1. API токенімен авторизация
Тексерулер кестеде келтірілген тәртіппен орындалады; жауап бұзылған тексерулердің біріншісі бойынша қалыптастырылады.
| HTTP | КОД | МАҒЫНАСЫ | ҰСЫНЫЛАТЫН ӘРЕКЕТ |
|---|---|---|---|
| 429 | too_many_auth_failures | 10 минут ішінде авторизацияның 30 сәтсіз әрекетінен кейін IP-мекенжайдан түскен сұраулар уақытша қабылданбайды. | Токен мәнін тексеріп, сұрауды 15 минуттан кейін қайталау. |
| 503 | api_disabled | API-ге сұрауларды қабылдау уақытша тоқтатылды. | Сұрауды кейінірек қайталау. |
| 401 | invalid_api_key | Токен берілмеген, қате көрсетілген немесе кері қайтарып алынған. | Авторизация тақырыбын тексеру; токен кері қайтарып алынған жағдайда жаңа токен алу үшін жүгіну. |
| 401 | token_expired | Токеннің қолданылу мерзімі аяқталды. | Жаңа токен шығару үшін университетке жүгіну. |
| 403 | token_blocked | Токенді университет әкімшілігі бұғаттаған. | Университетке жүгіну. |
| 403 | ip_not_allowed | Сұрау токен үшін рұқсат етілмеген IP-мекенжайдан жіберілген. | Сұрауларды рұқсат етілген мекенжайдан жіберу немесе мекенжайлар тізбесін өзгерту үшін жүгіну. |
| 404 | not_found | Жол ешбір модульге жатпайды немесе операцияға қолдау көрсетілмейді. | Сұрау жолын тексеру. |
| 403 | module_not_allowed | Модуль токенде көрсетілмеген. | Қолжетімділікті кеңейту үшін университетке жүгіну. |
| 503 | module_disabled | Модуль уақытша ажыратылған. | Сұрауды кейінірек қайталау. |
| 405 | method_not_allowed | Деректер модулі тек GET әдісімен жіберілген сұрауларды қабылдайды. Жауапта Allow: GET тақырыбы болады. | GET әдісін пайдалану. |
| 429 | rate_limit_exceeded | Минутына рұқсат етілген сұраулар саны асып кетті. | Сұрауды Retry-After тақырыбында көрсетілген уақыт өткен соң қайталау. |
| 400 | invalid_path | Сұрау жолында рұқсат етілмеген сегменттер бар: . және .., кодталған нүкте, қиғаш сызық немесе кері қиғаш сызық. | Жолды қызметтік сегменттерсіз және кодталған бөлгіштерсіз көрсету. |
| 413 | request_too_large | Сұрау денесінің көлемі рұқсат етілген мөлшерден асады. | Сұрау көлемін «Шектеулер және тақырыптар» бөлімінде көрсетілген шекке дейін азайту. |
| 400 | invalid_json | ALEM модуліне жіберілген сұраудың денесі дұрыс JSON нысаны болып табылмайды. | Сұрау денесін JSON нысаны түрінде беру. |
| 400 | invalid_multipart | Аудионы транскрипциялау сұрауының денесі дұрыс multipart/form-data құжаты болып табылмайды. | Файл мен параметрлерді бөліктер шекарасын көрсете отырып, multipart/form-data форматында беру. |
| 400 | model_required | ALEM модуліне жіберілген сұрауда модель көрсетілмеген. | Модельді GET /os/v1/alem/models жауабынан таңдап, model өрісінде көрсету. |
| 404 | model_not_found | Модель модельдер тізбесінде жоқ. | Модельді GET /os/v1/alem/models жауабынан таңдау. |
| 403 | model_not_allowed | Модельге токен рұқсат бермейді. | Рұқсат етілген модельді пайдалану немесе қолжетімділікті кеңейту үшін жүгіну. |
| 502 | upstream_auth_error | Ақпараттық жүйеге немесе Alem.Cloud платформасына жүгіну кезінде ішкі авторизация ақауы орын алды. | Сұрауды кейінірек қайталау; қате қайталанған жағдайда университетке сұрау идентификаторын хабарлау. |
| 502 | upstream_error | Ақпараттық жүйе немесе Alem.Cloud платформасы жауап бермеді не өңдеуді қатемен аяқтады. | Сұрауды кейінірек, аралықты біртіндеп арттыра отырып қайталау. |
| 503 | alem_unavailable | ALEM модулі уақытша қолжетімсіз. | Сұрауды кейінірек қайталау. |
| 500 | internal_error | Сұрауды өңдеу кезінде ішкі қате орын алды. | Сұрауды кейінірек қайталау; қате қайталанған жағдайда университетке сұрау идентификаторын хабарлау. |
9.2. «QAIRU арқылы кіру» авторизациясы
Студенттің қолжетімділік токенімен авторизация кезінде invalid_api_key, token_expired, token_blocked, ip_not_allowed және module_not_allowed кодтарының орнына мына кодтар қолданылады; қалған кодтар өзгеріссіз қолданылады.
| HTTP | КОД | МАҒЫНАСЫ | ҰСЫНЫЛАТЫН ӘРЕКЕТ |
|---|---|---|---|
| 401 | invalid_token | Қолжетімділік токені жарамсыз: қолтаңба тексеруден өтпеді, қолданылу мерзімі аяқталды немесе токен тіркелмеген қосымшаға берілген. | Қолжетімділік токенін refresh_token арқылы жаңарту; жаңарту сәтсіз болса, студентке қайта кіруді ұсыну. |
| 401 | token_revoked | Студент қосымшаның қолжетімділігін кері қайтарып алды; кері қайтарып алуға дейін берілген токендер қабылданбайды. | Студентке қайта кіріп, қолжетімділікті растауды ұсыну. |
| 403 | app_disabled | Қосымшаны университет әкімшілігі ажыратқан. | Университетке жүгіну. |
| 403 | student_only | Қолжетімділік токені студенттік емес есептік жазбаға берілген. | Студенттің есептік жазбасымен кіру. |
| 403 | scope_not_granted | Модульдің қолжетімділік аясын студент бермеген, ол қосымшаға рұқсат етілмеген немесе модуль ажыратылған. | Кіру кезінде модульдің қолжетімділік аясын сұрату немесе қосымша модульдерінің тізбесін кеңейту үшін университетке жүгіну. |
Деректер модуліне жіберілген сұрауды өңдеу кезінде ақпараттық жүйенің өзінде пайда болған қателер, мысалы, жоқ жазбаға арналған 404, ақпараттық жүйенің бастапқы форматында беріледі. Авторизация серверінің қателері «QAIRU арқылы кіру» бөлімінде келтірілген.