Dvina MCP

API அணுகலைப் பயன்படுத்தவும்

ஸ்கிரிப்ட்கள் மற்றும் MCP கிளையன்ட்களுக்கான தனிப்பட்ட அணுகல் டோக்கன்களை உருவாக்கவும். வெப்ஹுக்குகள் மூலம் உங்கள் Livespace நிகழ்வுகளை உங்கள் சொந்த அமைப்புகளுக்கு அனுப்பவும்.

Markdown வடிவில் பார்க்க

அமைப்புகள் › API அணுகல் பகுதியில் தனிப்பட்ட அணுகல் டோக்கன்களை உருவாக்கலாம். இவற்றைப் பயன்படுத்தி ஒரு ஸ்கிரிப்ட் அல்லது MCP கிளையன்ட் உங்கள் சார்பில் Dvina-ஐப் பயன்படுத்த முடியும். நிர்வாகிகள் அதே பகுதியில் வெப்ஹுக்குகளைச் சேர்த்து, Livespace நிகழ்வுகளைத் தங்கள் சொந்த அமைப்புகளுக்கு அனுப்பலாம்.

API அணுகல் Enterprise திட்டத்தில் கிடைக்கிறது. ஒவ்வொரு உறுப்பினரும் தங்களுக்கான டோக்கன்களை உருவாக்கலாம்; உரிமையாளர்களும் நிர்வாகிகளும் மட்டுமே வெப்ஹுக்குகள் பகுதியைப் பார்க்க முடியும்.

டோக்கனை உருவாக்கவும்

  1. அமைப்புகளைத் திறந்து API அணுகல் என்பதைத் தேர்ந்தெடுக்கவும்.
  2. தனிப்பட்ட அணுகல் டோக்கன்கள் பகுதியில் டோக்கனை உருவாக்கு என்பதைத் தேர்ந்தெடுக்கவும்.
  3. பின்னர் அதை எது பயன்படுத்துகிறது என்பதை அறிந்துகொள்ள ஒரு பெயரை உள்ளிடவும்.
  4. அணுகல் வகையைத் தேர்ந்தெடுக்கவும்: படிக்க மட்டும் அல்லது படிக்கவும் எழுதவும்.
  5. அது எப்போது காலாவதியாகும் என்பதைத் தேர்ந்தெடுக்கவும்: 30 நாட்களில், 90 நாட்களில், 365 நாட்களில் அல்லது காலாவதியாகாது.
  6. டோக்கனை உருவாக்கு என்பதைத் தேர்ந்தெடுக்கவும்.
  7. உங்கள் டோக்கனை நகலெடுக்கவும் பகுதியில் டோக்கனை நகலெடுத்து, பாதுகாப்பான இடத்தில் வைத்துக்கொள்ளவும். இந்த ஒரே முறை மட்டுமே அது காட்டப்படும்.

நீங்கள் டோக்கனை உருவாக்கிய Livespace-இல், அங்கு உங்களுக்கு தற்போது உள்ள பங்கின் அடிப்படையில் அது உங்கள் சார்பில் செயல்படும். படிக்க மட்டும் என்ற டோக்கனால் படிக்க முடியும்; ஆனால் எதையும் சேர்க்கவோ மாற்றவோ முடியாது.

MCP கிளையன்ட்டுடன் டோக்கனைப் பயன்படுத்த, OAuth-க்குப் பதிலாக API விசையுடன் இணைக்கவும் என்பதைப் பார்க்கவும்.

டோக்கனைச் சரிபார்க்கவும், புதுப்பிக்கவும் அல்லது ரத்து செய்யவும்

உங்கள் டோக்கன்கள் அவற்றின் அணுகல் வகையுடன் தனிப்பட்ட அணுகல் டோக்கன்கள் பகுதியில் பட்டியலிடப்படும். ஒரு டோக்கனைத் தேர்ந்தெடுத்து, அதன் தொடக்கம், அணுகல், கடைசியாகப் பயன்படுத்திய நேரம், காலாவதியாகும் நேரம் ஆகியவற்றைப் பார்க்கவும்.

  • டோக்கனை மாற்ற, புதுப்பி… என்பதைத் தேர்ந்தெடுத்து, உறுதிப்படுத்த புதுப்பி என்பதைத் தேர்ந்தெடுக்கவும். அதற்குப் பதிலாக ஒரு புதிய டோக்கன் உருவாக்கப்படும்; பழையது உடனடியாகச் செயல்படுவதை நிறுத்திவிடும். உங்கள் டோக்கனை நகலெடுக்கவும் பகுதியில் புதிய டோக்கனை நகலெடுக்கவும்.
  • டோக்கனை நிறுத்த, ரத்து செய்… என்பதைத் தேர்ந்தெடுத்து, உறுதிப்படுத்த ரத்து செய் என்பதைத் தேர்ந்தெடுக்கவும். அதைப் பயன்படுத்தும் அனைத்தும் உடனடியாகச் செயல்படுவதை நிறுத்திவிடும்.

டோக்கனை உருவாக்குவது, புதுப்பிப்பது, ரத்து செய்வது ஆகியவை தணிக்கைப் பதிவில் பதிவு செய்யப்படும்.

வெப்ஹுக்கைச் சேர்க்கவும்

நீங்கள் தேர்ந்தெடுக்கும் முகவரிக்கு Livespace நிகழ்வுகளை வெப்ஹுக் அனுப்பும். இவை தணிக்கைப் பதிவில் உள்ள அதே பதிவுகளாகும்.

  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 தொடர்ந்து முயற்சிக்கும்; தோல்வியைத் தணிக்கைப் பதிவில் பதிவு செய்யும்.
  • அதன் ரகசிய விசையை மாற்ற, புதிய கையொப்ப ரகசிய விசை… என்பதைத் தேர்வுசெய்து, உறுதிப்படுத்தவும். கோரிக்கைகள் உடனடியாகப் புதிய ரகசிய விசையுடன் கையொப்பமிடப்படும் என்பதால், அவற்றைப் பெறும் அமைப்பை உடனே புதுப்பிக்கவும்.
  • அதை அகற்ற, நீக்கு… என்பதைத் தேர்வுசெய்து, உறுதிப்படுத்த நீக்கு என்பதைத் தேர்வுசெய்யவும். அதற்கு இனி எதுவும் அனுப்பப்படாது.