# 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)