> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chattler.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API ачкычын алу

> Агентның Интеграцияләр битендә ачкычлар ясагыз, яңартыгыз һәм юегез.

Ачкычлар белән Chattler кушымтасында, агентның **Интеграцияләр** битендәге **API аша керү** карточкасында идарә ителә. Бер API чакыруы да ачкыч ясамый.

## Ачкыч ясау

<Steps>
  <Step title="Агентны ачыгыз">
    Кушымтада тышка чыгарасы агентны ачыгыз һәм аның **Интеграцияләр** битенә керегез.
  </Step>

  <Step title="API аша керү карточкасында ачкыч өстәгез">
    Ачкычка исем бирегез һәм рөхсәтен сайлагыз:

    * `read-only`: диалоглар исемлеге һәм хәбәрләрне уку.
    * `full`: өстәге барысы, өстәвенә чат эндпоинтлары.
  </Step>

  <Step title="Ачкычны хәзер үк күчереп алыгыз">
    Чын ачкыч ясалганнан соң **бер генә тапкыр** күрсәтелә. Ул менә болай күренә:

    ```text theme={null}
    cht_live_<key_id>.<secret>
    ```

    Аутентификацияне сер өлеше генә үти. `key_id` өлеше ачык һәм дашбордта һәр җирдә ачкычның идентификаторы булып тора. Серне югалтсагыз, ачкычны яңартыгыз.
  </Step>
</Steps>

## Ачкычны яңарту

Яңарту яңа сер бирә һәм искесен шунда ук гамәлдән чыгара. Ачкычның идентификаторы, аның диалоглары һәм статистикасы шул ук ачкычта кала, шуңа күрә сер ачылган дип шикләнгәндә яңарту — дөрес адым: башка бернәрсә дә үзгәрми.

## Ачкычны юю

Ачкычны юю аны бетерә. Шул мизгелдән аның белән һәр сорау `401 invalid_api_key` хатасы белән туктый, һәм бу беркайчан булмаган ачкычтан аерылмый. Аның диалоглары һәм сораулар тарихы дашбордта укырлык булып кала. Ююны кире кайтарып булмый; аның урынына яңа ачкыч ясагыз.

<Warning>
  **Ачкычны беркайчан да браузер бандлына, мобиль кушымтага яки сез контрольдә тотмаган башка клиентка салмагыз.** Ачкыч — хуҗаның балансын тотучы озак гамәлдәге хуҗа таныклыгы. API-га үз бэкендыгыздан мөрәҗәгать итегез һәм ачкыч ачылган дип шикләнгән мизгелдә үк аны яңартыгыз.
</Warning>

## Ачкыч белән аутентификация

`Bearer` схемалы `Authorization` башламы гына кабул ителә. Сорау юлындагы (query-string) таныклыклар санга сугылмый, дашборд токены да, `Browser-ID` башламы да катнашмый.

```http theme={null}
Authorization: Bearer cht_live_<key_id>.<secret>
```

Ачкыч бер агентка бәйләнгән. Аны башка `{agent_id}` белән куллану `403 agent_mismatch` кайтара.

## Статистика

Куллану API аша керү карточкасында күрсәтелми. Агентның **Статистика** битен ачыгыз һәм **Интеграция** фильтрында ачкычны сайлагыз; анда һәр ачкыч аерым интеграция буларак күрсәтелә. Бит һәр ачкыч һәм һәр UTC көне буенча сораулар санын, уңышлы һәм хаталы сорауларны, хаталар өлешен, уртача һәм p95 кичегүне, уникаль кулланучыларны, актив диалогларны, токеннарны һәм алынган сумманы, өстәвенә эндпоинтлар, HTTP-статуслар һәм хата кодлары буенча бүленешне күрсәтә. Провайдер бәясе беркайчан да күрсәтелми; күрсәтелгән сумма — баланстан алынган сумма.