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