> ## Documentation Index > Fetch the complete documentation index at: https://docs.tungo.kz/llms.txt > Use this file to discover all available pages before exploring further. # Кілт жұмыс істемейді > API кілті бойынша әр бас тарту — 401, 402, 403 және 429 — нені білдіреді және сұраулар қайта өтуі үшін не істеу керек. Бас тартудың себебін жауаптың өзі айтады: HTTP күйі және `error.code` өрісі. Төменде кодтар күйлер бойынша жиналған. Кілтті тексерудің ең жылдам жолы — оның өзі туралы сұрау: ```sh theme={null} curl -i "$TUNGO_API/v1/api-key" -H "x-api-key: $TUNGO_KEY" ``` Кілт қабылданбаса, себеп кодымен 401 келеді. Қабылданса, `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` Платформа балансы бос. Оны толтырыңыз: **Платформа → Баланс және төлем**, **Толтыру** батырмасы. Автотолтыру қосулы болса, ол іске қосылып қойған, сондықтан сұрауды сәл кейінірек қайталауға болады. Толығырақ [Платформа балансы және шығын](https://docs.tungo.kz/kk/platform/balance.md) бетінде. ### `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С қосу](https://docs.tungo.kz/kk/1c/overview.md) бөлімінде сипатталған. `turn_in_progress` коды басқа нәрсені білдіреді: бұл чатта алдыңғы жауап әлі жүріп жатыр. ## Тым жиі: 429 ### `rate_limited` Сұраулар бір кілтке немесе ұйымның барлық кілтіне минутына рұқсат етілгеннен көп. `Retry-After` тақырыбында қанша секунд көрсетілсе, сонша күтіп, қайталаңыз. Сіздің мекенжайыңыздан қате кілтпен көп сұрау келсе де осы бас тарту келеді: алдымен кілтті түзетіңіз. ### `concurrent_turns_limit` Кілт бойынша бір мезгілде ЖИ-бухгалтер жауаптарының шекті саны жүріп жатыр. Олардың біреуінің аяқталуын күтіңіз. Сұрақтар көп болса, оларды өз жағыңызда кезекке қойыңыз. ## Әрі қарай * [Қателер мен шектеулер](https://docs.tungo.kz/kk/platform/errors-and-limits.md): қатенің жалпы түрі және сұраулар жиілігінің тақырыптары. * [API кілтін жасау](https://docs.tungo.kz/kk/platform/api-keys.md): құқықтар, мерзім, кілтті қайта шығару және беру. * [Платформа балансы және шығын](https://docs.tungo.kz/kk/platform/balance.md): толтыру және шектер. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.