> ## 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-ն ձեր սեփական backend-ից և թարմացրեք բանալին այն պահին, երբ կասկածում եք, որ այն արտահոսել է:
</Warning>

## Նույնականացում բանալիով

Ընդունվում է միայն `Authorization` վերնագիրը `Bearer` սխեմայով: Հարցման տողի (query string) հավատարմագրերն անտեսվում են, և ոչ մի վահանակի թոքեն կամ `Browser-ID` վերնագիր ներգրավված չէ:

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

Բանալին կապված է մեկ գործակալի: Այն մեկ այլ `{agent_id}`-ի դեմ օգտագործելը վերադարձնում է `403 agent_mismatch`:

## Վիճակագրություն

Օգտագործումը չի ցուցադրվում «API մուտք» քարտում: Բացեք գործակալի **Վիճակագրություն** էջը և **Ինտեգրացիա** զտիչում ընտրեք բանալին; յուրաքանչյուր բանալի այնտեղ ներկայացված է որպես առանձին ինտեգրում: Այնուհետև էջը ցույց է տալիս, ըստ բանալու և ըստ UTC օրվա, հարցումների քանակը, հաջողված և ձախողված հարցումները, սխալների բաժինը, միջին և p95 ուշացումը, եզակի օգտատերերին, ակտիվ խոսակցությունները, թոքեններն ու գանձված գումարը, ինչպես նաև բաշխումն ըստ էնդփոինթների, HTTP կարգավիճակների և սխալի կոդերի: Մատակարարի արժեքը երբեք չի բացահայտվում; ցուցադրված գումարն այն է, ինչ գանձվել է հաշվեկշռից: