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