API কী দিয়ে নিজের সফটওয়্যার যুক্ত করুন

পাবলিক API আপনার বা ডেভেলপারের সফটওয়্যারকে Kluvan রেকর্ড পড়তে ও লিখতে দেয়: পণ্য, গ্রাহক, মজুত, রিপোর্ট, Books নথি, HR-এর মানুষ, CRM, সদস্যতা ও আপনার অ্যাপ। প্রতিটি কী আপনি নিয়ন্ত্রণ করেন: কী করতে পারবে, কতদিন এবং কোন শাখার জন্য।

শুরুর আগে

• শুধু মালিক কী তৈরি ও বাতিল করতে পারেন।
• প্রতিষ্ঠানে নেই এমন অ্যাপ কী খুলতে পারে না; প্ল্যান, অ্যাপ ও শাখার সব নিয়ম প্রযোজ্য থাকে।

ধাপ

1. সেটিংস → ডেভেলপার প্রবেশাধিকার খুলুন।
2. নতুন কী-তে চেনা যায় এমন নাম লিখুন, যেমন "গুদামের স্ক্যানার"।
3. যত দিন বৈধ (1–365) দিন। ডিফল্ট 90।
4. শাখা-তে সব শাখা রাখুন বা একটি শাখা বেছে নিন।
5. যা দেখতে পারে-তে প্রয়োজনীয় স্কোপ টিক দিন। প্রতিটিতে পড়া বা লেখা থাকে, যেমন পণ্য · পড়া।
6. নির্বাচিত প্রবেশাধিকার অনুমোদনের বাক্যে টিক দিন।
7. কী তৈরি করুন চাপুন।
8. এখনই কী কপি করুন। শুধু এই একবার দেখায়।
9. সফটওয়্যারকে কী দিন। সেটি Authorization: Bearer হেডারে পাঠায়।

API কল করা

• ঠিকানা https://api.kluvan.com/v1/public-api। ডেভেলপার নির্দেশিকা (/developers) উদাহরণ এবং প্রতিটি অপারেশনের প্রয়োজনীয় স্কোপ দেখায়। OpenAPI 3.1 অনুরোধের ঘরসহ পুরো চুক্তি ডাউনলোড করে।
• প্রতিটি লেখায় Idempotency-Key লাগে: প্রতি পরিবর্তনে নতুন UUID। উত্তর হারালে একই অনুরোধ একই কী দিয়ে সর্বোচ্চ 7 দিন আবার পাঠান; দুবার প্রয়োগ হয় না। বদলানো অনুরোধের সঙ্গে একই কী প্রত্যাখ্যাত হয়।
• বর্তমান রেকর্ড বদলাতে তার বর্তমান সংস্করণও (v) পাঠাতে হয়, যাতে পুরোনো কপি নতুনটিকে না মুছে দেয়।
• টাকা মুদ্রার সবচেয়ে ছোট এককে (150.00 হলো 15000)।
• অ্যাপ রেকর্ডের তালিকা সর্বোচ্চ 50 রেকর্ড ও next মান ফেরায়; পরের পাতা পেতে তা after হিসেবে পাঠান।
• কী পিছু মিনিটে সর্বোচ্চ 120 অনুরোধ। এরপর Retry-After-সহ 429 উত্তর আসে। প্রতি ত্রুটিতে কোড থাকে (ত্রুটির নির্দেশিকা দেখুন)।

জেনে রাখুন

• লেখার স্কোপ আসল রেকর্ড বদলায় এবং মজুত ও হিসাবের প্রভাবসহ অ্যাপের কাজ চালাতে পারে। কী-কে শুধু দরকারি স্কোপ দিন।
• শাখার কী শুধু শাখার রেকর্ড পড়ে। ক্যাটালগ, গ্রাহক, CRM, HR ও সদস্যতার অপারেশনে সব শাখার কী লাগে।
• Kluvan প্রতিটি কী-এর শুধু ফিঙ্গারপ্রিন্ট (হ্যাশ) রাখে। কী হারিয়েছে? বাতিল করে নতুনটি তৈরি করুন।
• বাতিল করুন সঙ্গে সঙ্গে কী থামায়। শেষ দিনেও কী থামে। সর্বোচ্চ 20টি কী রাখতে পারেন।
• API কার্যকলাপ প্রতিটি কল দেখায়: সময়, অপারেশন, কী ও অবস্থা। অনুরোধের বডি ও কী কখনও লেখা হয় না।
• API বিলিং, সাইন ইন, টাকা সংগ্রহ বা ওয়েবহুক দেয় না: বাইরে বিজ্ঞপ্তি যায় না, তাই সফটওয়্যার প্রয়োজনীয় তালিকা পড়ে।
• সাইন ইন করা ব্রাউজার সেশন এই API কল করতে পারে না, আর সহায়ক অ্যাপের কী আলাদা: সহায়ক অ্যাপ যুক্ত করুন দেখুন।