Ստեղծել բանալի
1
Բացեք գործակալը
Հավելվածում բացեք այն գործակալը, որը ցանկանում եք հասանելի դարձնել, և անցեք նրա Ինտեգրումներ էջ:
2
Ավելացրեք բանալի «API մուտք» քարտում
Բանալուն տվեք անվանում և ընտրեք նրա թույլտվությունը.
read-only՝ խոսակցությունների ցանկ և հաղորդագրությունների ընթերցում:full՝ վերը նշված ամեն ինչ, գումարած չատ-էնդփոինթները:
3
Պատճենեք բանալին հիմա
Բանալին ամբողջությամբ ցուցադրվում է մեկ անգամ՝ ստեղծումից անմիջապես հետո: Այն ունի հետևյալ տեսքը.Նույնականացնում է միայն գաղտնիքի մասը:
key_id մասը հրապարակային է և վահանակի ամենուր հանդես է գալիս որպես բանալու նույնացուցիչ: Եթե կորցնում եք գաղտնիքը, թարմացրեք բանալին:Թարմացնել բանալին
Թարմացումը տալիս է նոր գաղտնիք և անմիջապես անվավեր է դարձնում հինը: Բանալու նույնացուցիչը, նրա խոսակցությունները և վիճակագրությունը մնում են կցված նույն բանալուն, ուստի թարմացումը ճիշտ պատասխանն է արտահոսքի կասկածի դեպքում. ուրիշ ոչինչ չի փոխվում:Ջնջել բանալին
Բանալու ջնջումը հեռացնում է այն: Այդ պահից նրա հետ կատարված յուրաքանչյուր հարցում ձախողվում է401 invalid_api_key սխալով՝ չտարբերվելով երբեք գոյություն չունեցած բանալուց: Նրա խոսակցություններն ու հարցումների պատմությունը մնում են ընթեռնելի վահանակում: Ջնջումը հնարավոր չէ հետարկել; փոխարենը ստեղծեք նոր բանալի:
Նույնականացում բանալիով
Ընդունվում է միայնAuthorization վերնագիրը Bearer սխեմայով: Հարցման տողի (query string) հավատարմագրերն անտեսվում են, և ոչ մի վահանակի թոքեն կամ Browser-ID վերնագիր ներգրավված չէ:
{agent_id}-ի դեմ օգտագործելը վերադարձնում է 403 agent_mismatch: