error.code өрісі. Төменде кодтар күйлер бойынша жиналған. Кілтті тексерудің ең жылдам жолы — оның өзі туралы сұрау:
blocked_reason өрісін қараңыз: онда ЖИ-бухгалтерге жіберілген сұрау қазір алатын бас тартудың коды немесе, бәрі дұрыс болса, null тұрады. Кабинетте сол мәлімет «Қазір кілт жұмыс істемейді» тақырыбының астында жазылған: Платформа → API кілттері, кілт мәзірі, Толығырақ және шығын тармағы.
Осы беттегінің бәрін дерлік ұйымның иесі немесе әкімшісі кабинетте түзетеді. Кілттің өзімен кілттерді де, балансты да өзгертуге болмайды.
Кілт қабылданбады: 401
missing_credentials
Сұрау кілтсіз келді. Тақырыптың x-api-key деп аталатынын және кілт сақталған айнымалының бос емес екенін тексеріңіз. Authorization: Bearer tg_… тақырыбы да жарайды. Сұрауды браузердегі бет коды жіберсе, мәселе басқада: төмендегі cors_not_supported кодын қараңыз.
invalid_api_key
Мұндай кілт жоқ. Әдетте кілт толық көшірілмеген немесе артық бос орынмен не жол ауысуымен көшірілген. Кілт tg_ деп басталады, оның басын кілттер тізіміндегі «Кілт» бағанымен салыстырыңыз. Кілтті толық күйінде енді көру мүмкін емес: ол жоғалса, қайта шығарыңыз.
key_disabled
Кілтті кабинетте өшірген. Оны кілт авторы немесе ұйым иесі қоса алады: кілт мәзірі, Қосу тармағы. Бұл кезде құпия бұрынғыдай қалады, бағдарламада ештеңе өзгертудің керегі жоқ.
key_expired
Кілттің мерзімі бітті. Мерзімі өткен кілтті ұзартуға болмайды. Кілт авторы оны қайта шығара алады: кілт мәзірі, Қайта шығару тармағы. Құқықтар, компаниялар және шек сақталады, мерзім жаңадан басталады, бірақ құпия жаңа болады, және оны бағдарламада ауыстыру керек. Автор жоқ болса, жаңа кілт шығарыңыз.
key_revoked
Кілт кері қайтарылған, оны қалпына келтіру мүмкін емес. Сондай құқықтары бар жаңа кілт шығарып, оны бағдарламада ауыстырыңыз.
key_creator_lost_access
Кілт оны шығарған адамның атынан әрекет етеді. Бұл адам енді ұйымның иесі де, әкімшісі де емес, сондықтан кілт тоқтатылған. Ұйым иесі кілтті басқа иеге немесе әкімшіге бере алады: кілт мәзірі, Беру тармағы. Беру кезінде құпия мен мерзім өзгермейді.
Кілт қабылданды, бірақ ЖИ-бухгалтерге сұрау қабылданбады: 402
402 бас тартуы ақша немесе адамның шешімі керек екенін білдіреді. Қатедеresets_at өрісі бар жағдайлардан басқа кезде күтіп, қайталаудан пайда жоқ.
platform_balance_exhausted
Платформа балансы бос. Оны толтырыңыз: Платформа → Баланс және төлем, Толтыру батырмасы. Автотолтыру қосулы болса, ол іске қосылып қойған, сондықтан сұрауды сәл кейінірек қайталауға болады. Толығырақ Платформа балансы және шығын бетінде.
platform_cap_reached
Ұйымның шығысы айлық шекке жетті. Шек resets_at өрісіндегі сәтте өзі нөлденеді, бұл — Алматы уақыты бойынша келесі айдың басы. Ертерек жалғастыру үшін «Баланс және төлем» бетінде «Айлық шығын шегі» мәнін көтеріңіз.
key_cap_reached
Бұл кілт өзінің айлық шегіне жетті немесе шектің қалдығы модельді бір рет шақырудың бағалауынан аз. Ұйымның қалған кілттері жұмысын жалғастырады. Кілттің шегін оның авторы көтере алады: кілт мәзірі, Өзгерту тармағы. Әйтпесе кілт resets_at ішіндегі сәтте қайта жұмыс істейді.
platform_disabled
Платформа ұйымда өшірілген, сондықтан барлық кілт пен автоматтандыру тоқтатылған. «Баланс және төлем» бетінде «Платформа қосулы» ауыстырғышын қосыңыз.
Кілтке рұқсат жоқ: 403
missing_permission
Кілттің бұл әрекетке құқығы жоқ. Нақты қайсысы екені error.permission өрісінде айтылған, мысалы chat.use. Кілт авторы құқықты «Өзгерту» арқылы қоса алады, егер ол құқық осы компанияда оның өзінде болса. Әйтпесе басқа кілт шығарыңыз.
ip_not_allowed
Кілтке рұқсат етілген мекенжайлар тізімі берілген, ал сұрау басқа мекенжайдан келді. API-ді рұқсат етілген мекенжайдан шақырыңыз немесе «Рұқсат етілген мекенжайлар» өрісіне жаңасын қосыңыз. Мекенжайды тек кілт авторы қоса алады.
api_keys_disabled_by_policy
Ұйым API кілттеріне толық тыйым салған, сондықтан бірде-бір кілт жұмыс істемейді. «API кілттеріне рұқсат беру» баптауын ұйым иесі ұйым баптауларында қосады.
webhooks_require_all_companies
Вебхуктарды тек ұйымның барлық компаниясына арналған кілт басқарады, өйткені оқиғалар барлық компания бойынша келеді. Бұл үшін webhooks.manage құқығы бар, барлық компанияға арналған бөлек кілт шығарыңыз немесе мекенжайларды кабинетте қосыңыз.
cors_not_supported
Сұрау браузердегі бет кодынан жіберілген. API бұлай шақырылмайды: кілт — құпия және серверде қалуы керек. Шақыруды өз серверіңізге көшіріңіз.
Кілт жұмыс істейді, бірақ сұраулар 404 немесе 409 қайтарады
Анық бар компанияға 404
Бөгде және қолжетімсіз компаниялар жоқ компаниялар сияқты жауап береді. Кілт компанияларының тізімінGET /v1/companies сұрауымен тексеріңіз. Барлық компанияға арналған кілт тек авторы мүше болған компанияларды көреді: компания жақында ашылған болса, авторды оған қосу керек.
ЖИ-бухгалтерге қойылған сұраққа 409
Көбінесе компания 1С-ке қосылмаған, себебіerror.message ішінде жазылған. Қосылым күйін GET /v1/companies/{co}/onec/status көрсетеді. 1С-ті қалай қосу керегі 1С қосу бөлімінде сипатталған. turn_in_progress коды басқа нәрсені білдіреді: бұл чатта алдыңғы жауап әлі жүріп жатыр.
Тым жиі: 429
rate_limited
Сұраулар бір кілтке немесе ұйымның барлық кілтіне минутына рұқсат етілгеннен көп. Retry-After тақырыбында қанша секунд көрсетілсе, сонша күтіп, қайталаңыз. Сіздің мекенжайыңыздан қате кілтпен көп сұрау келсе де осы бас тарту келеді: алдымен кілтті түзетіңіз.
concurrent_turns_limit
Кілт бойынша бір мезгілде ЖИ-бухгалтер жауаптарының шекті саны жүріп жатыр. Олардың біреуінің аяқталуын күтіңіз. Сұрақтар көп болса, оларды өз жағыңызда кезекке қойыңыз.
Әрі қарай
- Қателер мен шектеулер: қатенің жалпы түрі және сұраулар жиілігінің тақырыптары.
- API кілтін жасау: құқықтар, мерзім, кілтті қайта шығару және беру.
- Платформа балансы және шығын: толтыру және шектер.