Ընդհանուր տեղեկատվություն
- Այս ֆունկցիան փորձնական է։ Այն կարող է փոխվել ապագա տարբերակներում։
- Անսահմանափակ ծրագրավորման ինտերֆեյսի (API) նշանները կարող են մուտք գործել API գործառույթներ, որոնք չունեն հարակից առանձնահատկություն։
Այս հատկությունը թույլ է տալիս ստեղծել, ցուցակագրել, թարմացնել եւ չեղարկել API նշանները: Սերվերը ճանաչում է API նշանները եւ թույլ է տալիս աշխատեցնել API գործառույթները: API գործառույթները թույլ են տալիս դիտել եւ փոխել հաշվի տվյալները՝ առանց cPanel ինտերֆեյս մուտք գործելու անհրաժեշտության: Դուք կարող եք թողարկել API նշաններ, որոնք թույլ են տալիս ուրիշներին աշխատեցնել API գործառույթները ձեր հաշվի տվյալներով: Օրինակ, դուք կարող եք թողարկել API նշան վերավաճառողին: Վերավաճառողը կարող է օգտագործել այդ նշանը՝ սկավառակի օգտագործումը ստուգելու համար։
- API նշանները գործարկում են UAPI ֆունկցիաները եւ cPanel API 2 ֆունկցիաները, այլ ոչ թե cPanel API 1 ֆունկցիաները։
- Օգտագործեք API նշաններ՝ API ֆունկցիաները հրամանի տողից գործարկելու համար։ Լրացուցիչ տեղեկությունների համար կարդացեք մեր Ինչպես օգտագործել cPanel API Tokens փաստաթղթերը:
- API գործառույթների օգտագործման մասին լրացուցիչ տեղեկությունների համար կարդացեք մեր Quickstart Development Guide փաստաթղթերը:
API token-ի ստեղծում
API token ստեղծելու համար կատարեք հետևյալ քայլերը՝
- Սեղմեք Create։ Կբացվի Create API Token միջերեսը։
- Մուտքագրեք եզակի անուն API Token Name դաշտում։
Նշում
- Անունը կարող է ունենալ առավելագույնը 50 նիշ
- Թույլատրվում են միայն՝
- տառեր (a–z, A–Z)
- թվեր (0–9)
- գծիկ (-)
- ընդգծում (_)
Վավերականության ժամկետ
Ընտրեք տարբերակ Should the API Token Expire? բաժնում՝
- The API Token will not expire
→ token-ը չի ունենա ժամկետ
- Specify an expiration date
→ կարող եք սահմանել ավարտի օր
Լռելյայն՝
- token-ը գործում է 1 տարի
Ընտրելուց հետո կհայտնվի API Token Expiration Date բաժինը՝
- կարող եք ընտրել օրացույցից
- կամ մուտքագրել ձեռքով՝
Կարևոր
Token-ը կավարտվի՝
- ընտրված օրը
- ժամը 23:59:59 (սերվերի ժամանակով)
-
-
Կարեւոր.
- Ստեղծումից հետո չեք կարող խմբագրել API նշանի ժամկետը:
- Երբ API նշանի ժամկետը լրանում է, համակարգը չի հեռացնի այն: Դուք պետք է ձեռքով ջնջեք API նշանը:
-
- Կտտացրեք Ստեղծել: Նոր ինտերֆեյս կհայտնվի:
- API նշանը պատճենելու համար կտտացրեք Պատճենել: Մտածեք այս նշանը գաղտնաբառի պես: Դուք պետք է մուտքագրեք այս նշանը ամեն անգամ, երբ օգտագործում եք այն:
Զգուշացում.
Դուք չեք կարող մուտք գործել նշանը ինտերֆեյսից հեռանալուց հետո: Եթե մոռանում եք կամ սխալ եք տեղադրում այս նշանը, ապա պետք է չեղարկեք նշանը եւ ստեղծեք նորը։
- API նշանը պատճենելու համար կտտացրեք Պատճենել: Մտածեք այս նշանը գաղտնաբառի պես: Դուք պետք է մուտքագրեք այս նշանը ամեն անգամ, երբ օգտագործում եք այն:
- Կտտացրեք Այո, ես պահեցի իմ նշանը:
- Նոր նշան ստեղծելու համար ընտրեք Ստեղծել մեկ այլ նշան Այո, ես պահեցի իմ նշանը նշատուփը:
- Ցուցակի API նշանների ինտերֆեյսին վերադառնալու համար ապաընտրեք Ստեղծել մեկ այլ նշան Այո, ես պահեցի իմ նշանի նշատուփը:
API նշանների աղյուսակ
Այս աղյուսակում ցուցադրվում են ձեր բոլոր API նշանները: Դուք կարող եք կատարել հետեւյալ գործառույթները.
- Յուրաքանչյուր էջում ավելի շատ API նշաններ ցուցադրելու համար սեղմեք փոխանցման պատկերակը (
), այնուհետեւ ընտրեք թիվը: - Մի քանի նշաններ չեղարկելու համար.
- Ընտրեք յուրաքանչյուր նշանի նշատուփերը, որոնք պետք է չեղարկվեն: Ընտրեք սեղանի վերեւի մասում գտնվող նշատուփը՝ յուրաքանչյուր նշան ընտրելու համար:
- Կտտացրեք Չեղարկել: Կհայտնվի հաստատման հաղորդագրություն:
- Կտտացրեք Չեղարկել ընտրված API նշանները:
API tokens աղյուսակը պարունակում է հետեւյալ տեղեկատվությունը.
- Token Name — API token-ի անունը:
- Ստեղծված — API նշանը ստեղծելու ամսաթիվը եւ ժամը:
- Expires — Եթե API token-ի ժամկետը լրանում է, ամսաթիվը եւ ժամը, երբ թոքենը կլրանա.
- Երբ API նշանի ժամկետը շուտով լրանա, ինտերֆեյսը ցույց է տալիս իր մուտքի տողը դեղին գույնով։ Այն նաեւ ցուցադրում է ծանուցման պատկերակ (
)։ - Ինտերֆեյսը կարմիր գույնով ցուցադրում է ժամկետանց API նշանների մուտքի տողերը: Այն նաեւ ցուցադրում է ծանուցման պատկերակ (
)։
Հիշեք՝Երբ API նշանների ժամկետը լրանում է, համակարգը դրանք չի հեռացնում։ Դուք պետք է ձեռքով ջնջեք սպառված API նշանները:
- Երբ API նշանի ժամկետը շուտով լրանա, ինտերֆեյսը ցույց է տալիս իր մուտքի տողը դեղին գույնով։ Այն նաեւ ցուցադրում է ծանուցման պատկերակ (
- Կառավարել — Սեղմեք Կառավարել՝ նոր ինտերֆեյս բացելու համար, որտեղ կարող եք կատարել հետեւյալ գործողությունները.
- Վերանվանել Token — Նշանակել նոր անուն token-ի համար:
- Revoce the Token — Ջնջել թոքենը եւ թույլ չտալ, որ այն մուտք գործի սերվեր կամ API ֆունկցիաներ։
Կառավարել API նշանը
API նշանը կառավարելու համար տեղակայեք նշանը API Tokens աղյուսակում եւ այնուհետեւ սեղմեք Կառավարել: Կհայտնվի Manage API Token ինտերֆեյսը:
Վերանվանել նշանը
Նշաձիմի համար նոր անուն նշանակելու համար մուտքագրեք նոր անուն Նոր API նշանի անուն տեքստատուփում: Այնուհետեւ սեղմեք Թարմացնել:
Չեղարկել թոքենը
Եթե դուք չեղյալ հայտարարեք API նշանը, օգտվողները չեն կարողանա աշխատեցնել որեւէ սցենար կամ API ֆունկցիա՝ օգտագործելով այդ նշանը։
API նշանը չեղարկելու համար.
- Կտտացրեք Չեղարկել: Կհայտնվի հաստատման հաղորդագրություն:
- Կտտացրեք Այո, չեղարկեք նշանը՝ նշանը չեղարկելու համար:
Հրամանի տողում API նշանը հեռացնելու համար օգտագործեք UAPI Tokens::revoke ֆունկցիան:
