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

​
Төп URL

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

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

Һәр сорауга Bearer схемалы Authorization башламында API ачкычы кирәк. Ачкыч Chattler кушымтасында ясала; API ачкычын алу битен карагыз.
Ачкычлар бер агентка бәйләнгән һәм рөхсәт йөртә: ике GET эндпоинты өчен read-only, шулар өстенә ике POST чат эндпоинты өчен full.

​
Килешүләр

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

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

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