> ## 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>

## Аутентификатсия бо калид

Танҳо сарлавҳаи `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 ва коди хато нишон медиҳад. Арзиши провайдер ҳеҷ гоҳ ошкор намешавад; маблағи нишондодашуда он аст, ки аз баланс ситонида шудааст.