API কী, স্কোপ ও টেস্ট মোড
সংক্ষিপ্ত উত্তর
Pro ও Team-এ API কী তৈরি করুন ড্যাশবোর্ড > ডোমেইন ও API-তে। প্রতিটি কী-এর একটি স্কোপ (শুধু পড়া, পড়া ও লেখা বা সম্পূর্ণ অ্যাক্সেস) আর একটি মোড থাকে: লাইভ কী (pf_live_) সত্যিই কাজ করে, টেস্ট কী (pf_test_) কখনো কাউকে ইমেল করে না এবং তার ট্রান্সফার 24 ঘণ্টা পরে মেয়াদোত্তীর্ণ হয়।
Pandafile API দিয়ে আপনার নিজের অ্যাপ, স্ক্রিপ্ট ও সার্ভার ফাইল পাঠাতে, আপলোড সংগ্রহ করতে আর স্বাক্ষরের অনুরোধ করতে পারে। এটি Pro ও Team-এ অন্তর্ভুক্ত এবং ওয়েবসাইটের মতোই সীমা মেনে চলে। সবকিছু শুরু হয় একটি API কী দিয়ে।
একটি কী তৈরি করুন
- সাইন ইন করে ড্যাশবোর্ড > ডোমেইন ও API খুলুন।
- "API কী"-এর নিচে কী-টির একটি নাম দিন, যেমন "ওয়েবসাইট আপলোড"।
- কী মোড বেছে নিন, "লাইভ" বা "টেস্ট", আর কী-এর অ্যাক্সেস: "সম্পূর্ণ অ্যাক্সেস", "পড়া ও লেখা" বা "শুধু পড়া"।
- "কী তৈরি করুন" চাপুন এবং কী-টি সঙ্গে সঙ্গে কপি করুন। আপনার নিরাপত্তার জন্য আমরা এটি মাত্র একবার দেখাই।
- প্রতিটি অনুরোধে এটি হেডার Authorization: Bearer আর তার পরে কী হিসেবে পাঠান।
সর্বোচ্চ 10টি সক্রিয় কী রাখতে পারেন। লাইভ কী শুরু হয় pf_live_ দিয়ে, টেস্ট কী pf_test_ দিয়ে। ডেভেলপার গাইড আছে pandafile.co/developers-এ এবং API রেফারেন্স pandafile.co/developers/api-এ।
স্কোপ: একটি কী কী করতে পারে
- শুধু পড়া: শুধু GET অনুরোধ। কী-টি জিনিস দেখতে পারে, কিন্তু কিছু বদলাতে পারে না।
- পড়া ও লেখা: "শুধু পড়া"-র সবকিছু, সঙ্গে ট্রান্সফার, ফাইল রিকোয়েস্ট, স্বাক্ষরের অনুরোধ ও ওয়েবহুক সাবস্ক্রিপশন তৈরি, পরিবর্তন ও মুছে ফেলা।
- সম্পূর্ণ অ্যাক্সেস: সবকিছু, অ্যাকাউন্ট সেটিংস যেমন ব্র্যান্ডিং ও টিম আমন্ত্রণসহ।
টেস্ট মোড
- pf_test_ কী দিয়ে তৈরি ট্রান্সফার টেস্ট ডেটা। কাউকে কখনো ইমেল করা হয় না, আপনার যোগ করা প্রাপকদেরও না।
- টেস্ট ট্রান্সফার তৈরির 24 ঘণ্টা পরে সবসময় মেয়াদোত্তীর্ণ হয় এবং বাড়ানো যায় না।
- এগুলো কোনো সীমা, স্টোরেজ বা ব্যবহারে গোনা হয় না, এবং আপনার সাধারণ ট্রান্সফার তালিকায় দেখা যায় না।
- এদের ওয়েবহুক ইভেন্টে livemode false থাকে, এবং এগুলো কখনো Slack, Microsoft Teams বা Discord-এ যায় না।
- কয়েকটি কাজ শুধু লাইভ কী দিয়ে হয়। টেস্ট কী দিয়ে করলে API test_mode_unsupported এরর দেয়।
কী নিরাপদে রাখুন
- যাঁর কাছে কী আছে, তিনি আপনার অ্যাকাউন্ট থেকে ফাইল পাঠাতে পারেন। কী নিজের সার্ভারে রাখুন, কখনো কোনো ওয়েবসাইট বা অ্যাপের পাবলিক কোডে নয়।
- কোনো কী ফাঁস হয়ে থাকতে পারে মনে হলে ড্যাশবোর্ড > ডোমেইন ও API-তে সেটি বাতিল করুন। এটি ব্যবহারকারী অ্যাপগুলো সঙ্গে সঙ্গে কাজ বন্ধ করে, এবং এটি দিয়ে তৈরি ওয়েবহুক সাবস্ক্রিপশন, যেমন Zapier বা Make-এর, সেগুলোও থেমে যায়।
- প্রতিটি কী-এর নিজস্ব রেট লিমিট আছে। প্রতিটি উত্তর RateLimit হেডারে জানায় আপনি কোথায় আছেন।
- টিমে API কী ব্যক্তিগত: প্রত্যেক সদস্য নিজের কী নিজে তৈরি করেন।