Skip to main content
Калидҳо дар барномаи Chattler, дар саҳифаи Интегратсияҳо-и агент, дар корти Дастрасӣ тавассути API идора карда мешаванд. Ҳеҷ як дархости API калид намесозад.

​
Сохтани калид

1

Агентро кушоед

Дар барнома агентеро, ки мехоҳед дастрас кунед, кушоед ва ба саҳифаи Интегратсияҳо-и он гузаред.
2

Дар корти Дастрасӣ тавассути API калид илова кунед

Ба калид ном диҳед ва иҷозати онро интихоб кунед:
  • read-only: рӯйхати муколамаҳо ва хондани паёмҳо.
  • full: ҳамаи боло, илова бар эндпоинтҳои чат.
3

Калидро ҳозир нусха бардоред

Калиди хом як маротиба, бевосита пас аз сохтан нишон дода мешавад. Он чунин менамояд:
Танҳо қисми махфӣ аутентификатсия мекунад. Қисми key_id кушода аст ва идентификатори калид дар тамоми панел мебошад. Агар махфиро гум кунед, калидро навсозӣ кунед.

​
Навсозии калид

Навсозӣ махфии нав медиҳад ва кӯҳнаро фавран беэътибор мекунад. Идентификатори калид, муколамаҳо ва омори он ба ҳамон калид пайваста мемонанд, бинобар ин навсозӣ ҷавоби дуруст ба ихроҷи гумонбаршуда аст: чизи дигар тағйир намеёбад.

​
Ҳазф кардани калид

Ҳазф кардани калид онро нест мекунад. Аз он лаҳза ҳар дархост бо он бо 401 invalid_api_key ноком мешавад, ки аз калиди ҳеҷ гоҳ вуҷуднадошта фарқ намекунад. Муколамаҳо ва таърихи дархостҳои он дар панел хонданӣ мемонанд. Ҳазфро бекор кардан мумкин нест; ба ҷои он калиди нав созед.
Ҳеҷ гоҳ калидро дар бандчаи браузер, барномаи мобилӣ ё ягон мизоҷе, ки шумо назорат намекунед, ҷойгир накунед. Калид эътимодномаи дарозмуддати соҳиб аст, ки баланси соҳибро сарф мекунад. API-ро аз бэкенди худ даъват кунед ва ҳамин ки ба ихроҷ гумон кардед, калидро навсозӣ кунед.

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

Танҳо сарлавҳаи Authorization бо схемаи Bearer қабул мешавад. Эътимодномаҳо дар query-string нодида гирифта мешаванд ва ҳеҷ токени панел ё сарлавҳаи Browser-ID иштирок намекунад.
Калид ба як агент баста аст. Истифодаи он бо {agent_id}-и дигар 403 agent_mismatch бармегардонад.

​
Омор

Истифода дар корти Дастрасӣ тавассути API нишон дода намешавад. Саҳифаи Омор-и агентро кушоед ва калидро дар филтри Интегратсия интихоб кунед; ҳар калид дар он ҷо ҳамчун интегратсияи алоҳида номбар шудааст. Пас саҳифа барои ҳар калид ва ҳар рӯзи UTC шумораи дархостҳо, дархостҳои муваффақ ва бохато, ҳиссаи хатоҳо, таъхири миёна ва p95, корбарони беназир, муколамаҳои фаъол, токенҳо ва маблағи пардохтшударо, инчунин тақсимот аз рӯи эндпоинт, статуси HTTP ва коди хато нишон медиҳад. Арзиши провайдер ҳеҷ гоҳ ошкор намешавад; маблағи нишондодашуда он аст, ки аз баланс ситонида шудааст.