# የAPI መዳረሻን ይጠቀሙ

> ለስክሪፕቶች እና ለMCP ደንበኛ ፕሮግራሞች የግል መዳረሻ ቶከኖችን ይፍጠሩ፣ እና በዌብሁኮች አማካይነት የLivespaceዎን ክስተቶች ወደ ራስዎ ስርዓቶች ይላኩ።

በቅንብሮች › **የAPI መዳረሻ** ውስጥ የግል መዳረሻ ቶከኖችን ይፈጥራሉ። በዚህም ስክሪፕት ወይም የMCP ደንበኛ ፕሮግራም Dvinaን እርስዎን ወክሎ መጠቀም ይችላል። አስተዳዳሪዎችም የLivespace ክስተቶችን ወደ ራሳቸው ስርዓቶች ለመላክ እዚያው ዌብሁኮችን ይጨምራሉ።

የAPI መዳረሻ በEnterprise ዕቅድ ውስጥ ተካትቷል። እያንዳንዱ አባል የራሱን ቶከኖች መፍጠር ይችላል፤ **ዌብሁኮች** ግን የሚታዩት ለባለቤቶች እና ለአስተዳዳሪዎች ብቻ ነው።

## ቶከን ይፍጠሩ

1. ቅንብሮችን ይክፈቱና **የAPI መዳረሻ**ን ይምረጡ።
2. በ**የግል መዳረሻ ቶከኖች** ስር፣ **ቶከን ፍጠር**ን ይምረጡ።
3. በኋላ ምን እንደሚጠቀምበት ለማወቅ፣ **ስም** ያስገቡ።
4. **መዳረሻ**ውን ይምረጡ፦ **ማንበብ ብቻ** ወይም **ማንበብ እና መጻፍ**።
5. **ጊዜው የሚያበቃበትን** ይምረጡ፦ **በ30 ቀናት ውስጥ**፣ **በ90 ቀናት ውስጥ**፣ **በ365 ቀናት ውስጥ** ወይም **ጊዜው አያበቃም**።
6. **ቶከን ፍጠር**ን ይምረጡ።
7. በ**ቶከንዎን ይቅዱ** ስር፣ ቶከኑን ይቅዱና በደህንነቱ በተጠበቀ ቦታ ያስቀምጡት። የሚታየው በዚህ ጊዜ ብቻ ነው።

ቶከን በፈጠሩበት Livespace ውስጥ፣ እዚያ አሁን ባለዎት ሚና፣ እርስዎን ወክሎ ይሠራል። **ማንበብ ብቻ** የሚፈቅድ ቶከን ማንበብ ይችላል፣ ግን ምንም መጨመር ወይም መቀየር አይችልም።

ቶከንን ከMCP ደንበኛ ፕሮግራም ጋር ለመጠቀም፣ [ከOAuth ይልቅ በAPI ቁልፍ ይገናኙ](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth)ን ይመልከቱ።

## ቶከን ይፈትሹ፣ ይተኩ ወይም ይሰርዙ

ቶከኖችዎ ከሚፈቅዱት መዳረሻ ጋር በ**የግል መዳረሻ ቶከኖች** ስር ተዘርዝረዋል። አንዱን ይምረጡና **የሚጀምርበትን**፣ **መዳረሻ**ውን፣ **ለመጨረሻ ጊዜ ጥቅም ላይ የዋለበትን** እና **ጊዜው የሚያበቃበትን** ይመልከቱ።

- **ቶከንን ለመተካት**፣ **ተካ…**ን ይምረጡ፣ ከዚያ ለማረጋገጥ **ተካ**ን ይምረጡ። አዲስ ቶከን ቦታውን ይወስዳል፣ አሮጌውም ወዲያውኑ መሥራት ያቆማል። አዲሱን ቶከን በ**ቶከንዎን ይቅዱ** ስር ይቅዱ።
- **ቶከንን ለማቆም**፣ **ሰርዝ…**ን ይምረጡ፣ ከዚያ ለማረጋገጥ **ሰርዝ**ን ይምረጡ። የሚጠቀምበት ማንኛውም ነገር ወዲያውኑ መሥራት ያቆማል።

ቶከን መፍጠር፣ መተካት እና መሰረዝ በ[ኦዲት መዝገብ](/docs/teams/audit-log) ውስጥ ይመዘገባሉ።

## ዌብሁክ ይጨምሩ

ዌብሁክ የLivespace ክስተቶችን፣ በ[ኦዲት መዝገብ](/docs/teams/audit-log) ውስጥ ካሉት ጋር ተመሳሳይ የሆኑ መዝገቦችን፣ ወደ መረጡት አድራሻ ይልካል።

1. በቅንብሮች › **የAPI መዳረሻ** ውስጥ፣ በ**ዌብሁኮች** ስር፣ **ዌብሁክ ጨምር**ን ይምረጡ።
2. **ስም** እና **URL** ያስገቡ። በይፋ ተደራሽ የሆነ የHTTPS URL ይጠቀሙ።
3. በ**ክስተቶች** ስር፣ ሁሉንም ክስተቶች ለማግኘት ባዶ ይተዉት፣ ወይም እንደ `member.added` ወይም `sharing.*` ያሉ ድርጊቶችን እና ክፍሎችን ይዘርዝሩ።
4. **ጨምር**ን ይምረጡ።
5. በ**የፊርማ ሚስጥሩን ይቅዱ** ስር፣ ሚስጥሩን ይቅዱ። የሚታየው በዚህ ጊዜ ብቻ ነው።

Dvina **ይህ አድራሻ ከDvina ተደራሽ አይደለም** ካለ፣ በይፋ ተደራሽ የሆነ የHTTPS URL ይጠቀሙ።

### የእያንዳንዱን ጥያቄ ፊርማ ያረጋግጡ

Dvina ክስተቶችን በቡድን፣ በJSON ቅርጸት ይልካል፣ እና እያንዳንዱን ጥያቄ በፊርማ ያረጋግጣል። ጥያቄው ከDvina መምጣቱን ለማረጋገጥ የፊርማ ሚስጥሩን ይጠቀሙ፦

- እያንዳንዱ ጥያቄ እንደ `t=<timestamp>,v1=<signature>` ያለ የ`X-Dvina-Signature` ራስጌ አለው።
- ፊርማው የጊዜ ማህተምን፣ ነጥብን እና የጥያቄውን ይዘት በማጣመር፣ በእርስዎ የፊርማ ሚስጥር የሚፈጠር HMAC-SHA256 ሲሆን፣ በሄክሳዴሲማል ቅርጸት ይቀርባል።
- ራስዎ ያስሉትና ያነጻጽሩ። ፊርማው የማይዛመድ ወይም የጊዜ ማህተሙ በጣም የቆየ ጥያቄን ውድቅ ያድርጉ።

## ዌብሁክን ያረጋግጡ ወይም ይቀይሩ

ዌብሁኮችዎ በ**ዌብሁኮች** ስር ከሁኔታቸው ጋር ይዘረዘራሉ፦ **በርቷል**፣ **ባለበት ቆሟል** ወይም **እየከሸፈ ነው**። ዝርዝሩን ለማየት አንዱን ይምረጡ።

- **ለመቀየር**፣ **ስም**፣ **URL** ወይም **ክስተቶች**ን ያርትዑ፣ ከዚያ **አስቀምጥ**ን ይምረጡ።
- **ለጊዜው ለማቆም**፣ **ክስተቶችን ላክ**ን ያጥፉ። መላክን እንደገና ለመጀመር መልሰው ያብሩት።
- **እንዴት እየሠራ እንደሆነ ለማየት**፣ **ሁኔታ**ውን እና ምን ያህል ክስተቶች **እንደተላኩ** ያረጋግጡ። እየከሸፈ ያለ ዌብሁክ **የመጨረሻውን ስህተት** ያሳያል። Dvina መሞከሩን ይቀጥላል፣ አለመሳካቱንም በኦዲት መዝገቡ ውስጥ ይመዘግባል።
- **ሚስጥሩን ለመቀየር**፣ **አዲስ የፊርማ ሚስጥር…**ን ይምረጡ፣ ከዚያ ያረጋግጡ። ጥያቄዎች ወዲያውኑ በአዲሱ ሚስጥር ይፈረማሉ፣ ስለዚህ ተቀባዩን ወዲያውኑ ያዘምኑ።
- **ለማስወገድ**፣ **ሰርዝ…**ን ይምረጡ፣ ከዚያ ለማረጋገጥ **ሰርዝ**ን ይምረጡ። ከዚያ በኋላ ምንም ነገር አይላክለትም።

## ተዛማጅ

- [በMCP አማካይነት Dvinaን ከሌሎች መተግበሪያዎች ይጠቀሙ](/docs/dvina-mcp/overview)
- [የኦዲት መዝገቡን ይጠቀሙ](/docs/teams/audit-log)
- [የቡድኖች አጠቃላይ እይታ](/docs/teams/overview)