API ও এজেন্ট
স্ক্রিপ্ট, বট এবং AI এজেন্ট x402 API-এর মাধ্যমে Watchdog ব্যবহার করতে পারে, অ্যাপে আপনি যে ওয়ালেট, ক্রেডিট, ওয়াচ ও প্রাপক দেখেন সেগুলো দিয়েই।
সর্বশেষ আপডেট: ৩০ সেপ, ২০২৬Watchdog পাতায় আপনি যা কিছু করেন, তার সবই /api/x402-এর অধীনেও পাওয়া যায়: ওয়াচ তালিকা দেখা ও তৈরি করা, সিগন্যাল ও রাউটিং বদলানো, প্রাপক পরিচালনা ও টেস্ট পাঠানো, অ্যালার্ট ইতিহাস পড়া ও এক্সপোর্ট করা, মূল্য জানা, স্লট কেনা এবং ক্রেডিট টপ-আপ করা। API-এর মাধ্যমে করা পরিবর্তন সঙ্গে সঙ্গে অ্যাপে দেখা যায়, এবং উল্টোটাও।
একটি মেশিন পাসওয়ার্ড দিয়ে নয়, ওয়ালেট দিয়ে সাইন ইন করে। প্রক্রিয়াটি পাঁচ ধাপের:
- ওয়ালেট ঠিকানা, অনুরোধ করা স্কোপ এবং টোকেনের জন্য একটি ঐচ্ছিক নামসহ POST /api/x402/auth/challenge।
- উত্তরে SIWE ফরম্যাটে (EIP-4361) একটি সাইন-ইন বার্তা থাকে। এটি ৫ মিনিট বৈধ এবং অনুরোধ করা স্কোপগুলোর তালিকা দেয়।
- ওয়ালেট বার্তাটি স্বাক্ষর করে। EIP-1271 সমর্থনকারী স্মার্ট-কন্ট্র্যাক্ট ওয়ালেটও কাজ করে।
- বার্তা ও স্বাক্ষরসহ POST /api/x402/auth/token।
- উত্তরে fbx_ দিয়ে শুরু হওয়া একটি টোকেন এবং তার মেয়াদ থাকে, ডিফল্টভাবে ২৪ ঘণ্টা। মেশিনটি এটি Authorization: Bearer হেডারে পাঠায়।
টোকেনটি শুধু ওই উত্তরেই দেখানো হয়। এটি পাসওয়ার্ডের মতো যত্ন করে রাখুন।
- read সবসময় অন্তর্ভুক্ত: ওয়াচ, প্রাপক, অ্যালার্ট, মূল্য এবং অ্যাকাউন্ট পড়া।
- write পরিবর্তনের অনুমতি দেয়: ওয়াচ, প্রাপক ও সেটিং তৈরি ও সম্পাদনা।
- spend ক্রেডিট খরচ হয় এমন কাজের অনুমতি দেয়, যেমন স্লট কেনা।
উদাহরণ: শুধু অ্যালার্ট দেখায় এমন একটি ড্যাশবোর্ডের read দরকার। নতুন টিম সদস্যদের জন্য ওয়াচ সেট আপ করে এমন একটি বটের read ও write দরকার। যে এজেন্ট নিজে থেকে স্লটও কেনে তার read, write ও spend দরকার। কোনো স্কোপ না থাকলে API insufficient_scope কোডসহ 403 উত্তর দেয় এবং প্রয়োজনীয় স্কোপের নাম জানায়।
আপনার ওয়ালেটের সব টোকেন অ্যাকাউন্ট সেটিংস → API অ্যাক্সেস পাতায় তালিকাভুক্ত থাকে, নাম, তৈরির তারিখ, মেয়াদ এবং শেষ ব্যবহারসহ। বাতিল করুন একটি টোকেন সঙ্গে সঙ্গে বন্ধ করে; এটি আর ফেরানো যায় না। একটি ওয়ালেটের একই সময়ে সর্বোচ্চ ১০টি সক্রিয় টোকেন থাকতে পারে। মেশিন নিজেই DELETE /api/x402/auth/tokens/{id} দিয়ে একটি টোকেন বাতিল করতে পারে।
প্রতিটি মেশিনকে নিজস্ব নামসহ আলাদা টোকেন দিন, এবং শুধু তার প্রয়োজনীয় স্কোপ দিন। কোনো মেশিন আপোসকৃত হলে আপনি শুধু সেই একটি টোকেন বাতিল করেন, আর অন্য কিছু বন্ধ হয় না।
যে অনুরোধ কিছু তৈরি করে বা ক্রেডিট খরচ করে তার জন্য Idempotency-Key হেডার লাগে, যার মান ৮ থেকে ১২৮টি অক্ষর, সংখ্যা, _ বা - দিয়ে গঠিত। সংযোগ বিচ্ছিন্ন হলে মেশিনটি একই কী দিয়ে একই অনুরোধ আবার পাঠায় এবং দুবার অর্থ দেওয়ার বদলে প্রথম ফলাফলটি পায়। ভিন্ন অনুরোধে একই কী ব্যবহার করলে idempotency_key_reused দিয়ে প্রত্যাখ্যান করা হয়।
কোনো ওয়াচের স্লট দরকার হলে বা ব্যালেন্স খুব কম হলে API 402 উত্তর দেয়। উত্তরে slot_required বা insufficient_credits কোড, একটি প্রস্তুত কেনার প্রস্তাব এবং টপ-আপের এন্ডপয়েন্ট থাকে। তখন একটি এজেন্ট নিজেই সিদ্ধান্ত নিতে পারে, অথবা আগে আপনাকে জিজ্ঞেস করতে পারে।
- সব অপারেশনের OpenAPI বিবরণ, স্কোপ ও ত্রুটি কোডসহ।
- আপনার ওয়েবহুক যে অ্যালার্ট পায় তার জন্য ওয়েবহুক স্কিমা v2।
- ভাষা মডেলের জন্য সংক্ষিপ্ত প্রবেশপথ হিসেবে llms.txt।
- RFC 9727 অনুযায়ী API ক্যাটালগ।
- মানুষের জন্য কোড উদাহরণসহ API ডকুমেন্টেশন।