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

# Кереш

> Һәр эндпоинт өчен уртак төп URL, аутентификация һәм килешүләр.

<Note>
  Бу API белешмәсе бүлегендәге эндпоинт битләре (сорау һәм җавап схемалары, уен мәйданчыгы) OpenAPI схемасыннан ясала һәм инглиз телендә генә бар. Татарча кулланмалар шул ук эшләү тәртибен тасвирлый.
</Note>

## Төп URL

Барлык эндпоинтлар `https://api.chattler.ai/v1` астында урнашкан. HTTPS кына хезмәт күрсәтелә.

## Аутентификация

Һәр сорауга `Bearer` схемалы `Authorization` башламында API ачкычы кирәк. Ачкыч Chattler кушымтасында ясала; [API ачкычын алу](/tt/get-started/api-key) битен карагыз.

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

Ачкычлар бер агентка бәйләнгән һәм рөхсәт йөртә: ике `GET` эндпоинты өчен `read-only`, шулар өстенә ике `POST` чат эндпоинты өчен `full`.

## Килешүләр

* Сорау һәм җавап тәннәре — JSON (`Content-Type: application/json`), `text/event-stream` белән җавап бирүче агымлы эндпоинттан тыш.
* Ике чат эндпоинты да һәр логик сорау өчен уникаль, 1-255 символлы `Idempotency-Key` башламын таләп итә. [Идемпотентлык](/tt/guides/idempotency) битен карагыз.
* Һәр җавапта `X-Request-ID` бар. `X-RateLimit-Limit`, `X-RateLimit-Remaining` һәм `X-RateLimit-Reset` лимит башламнары JSON `200` җавапларында һәм `429` җавабында бар; SSE агымы һәм башка хата җаваплары аларны йөртми. [Сораулар лимитлары](/tt/guides/rate-limits) битен карагыз.
* Һәр уңышсызлык — `{"error": {"code", "message", "request_id"}}`. [Хаталар](/tt/guides/errors) битен карагыз.
* Исемлекләр — `{"data": [...], "next_cursor": "..." | null}`; `limit` 1-100, килешү буенча 20.
* Вакыт тамгалары — UTC-да ISO-8601. Фильтрлар вакыт поясы күрсәтелгән дә, күрсәтелмәгән дә кыйммәтләрне кабул итә (күрсәтелмәгәне UTC дип укыла); `date_to` керми (эксклюзив).

## Уен мәйданчыгында сынап карагыз

Эндпоинт битләрендә уен мәйданчыгы бар. Bearer токены буларак чын ачкычны куегыз һәм ачкыч караган агент идентификаторын кулланыгыз; сораулар турыдан-туры `https://api.chattler.ai` адресына китә һәм башка теләсә нинди чакыру кебек түләнә.

<Warning>
  `full` ачкычны уртак экранга яки язмага куймагыз. Куйган булсагыз, кушымтада аны яңартыгыз.
</Warning>