full рөхсәтле ачкыч кирәк (API ачкычын алу битен карагыз). Барлык мисаллар аларны өч мохит үзгәрешеннән укый:
Хәбәр җибәрү
POST /v1/agents/{agent_id}/chat бер кулланучы хәбәрен җибәрә һәм җавапны көтә. Content-Type башламыннан тыш тагын ике башлам мөһим:
Authorization: Bearer <key>Idempotency-Key: һәр логик сорау өчен 1-255 символлы теләсә нинди уникаль кыйммәт. UUID — яхшы сайлау. Ул ике чат эндпоинтында да мәҗбүри; Идемпотентлык битен карагыз.
Җавапны уку
request_idX-Request-IDбашламы буларак та кайтарыла.conversation_id— алмашу сакланган диалог. Шул укexternal_user_idбелән тагын бер хәбәр җибәрегез, һәм ул шунда дәвам итә.usage.charged_usd— 8 урынлы дистә юл: бу сорау хуҗаның балансына никадәр торды.
Диалогны дәвам итү
Шул укexternal_user_id һәм яңа Idempotency-Key белән икенче хәбәр җибәрегез:
Retry-After: 2 белән 409 conversation_busy кайтара; көтегез һәм кабатлагыз.
Киләсе адымнар
Агымлы җавап
Җавапны ясалган саен күрсәтегез.
Диалоглар
Диалоглар исемлеген алыгыз һәм хәбәрләрне битләп карагыз.
Хаталар
API кайтара алган һәр код һәм аның белән нәрсә эшләргә.
API белешмәсе
Тулы сорау һәм җавап схемалары, уен мәйданчыгы белән.