YoozMarket API কী: নিজের প্যানেল বা স্ক্রিপ্ট থেকে অর্ডার করুন
হালনাগাদ:
আপনার নিজের প্যানেল, বট বা স্ক্রিপ্ট থাকলে ড্যাশবোর্ডের বদলে কোড দিয়ে YoozMarket অর্ডার দিতে পারেন। এই গাইডে কী কীভাবে কাজ করে, কী কী অ্যাকশন আছে এবং আপনার ওয়ালেটে কী ঘটে তা বলা হয়েছে।
কী তৈরি করুন ও নিরাপদে রাখুন
ড্যাশবোর্ডে API খুলে একটি কী তৈরি করুন। নাম দিন যাতে মনে থাকে কোথায় ব্যবহার হচ্ছে; সর্বোচ্চ ৫টি সক্রিয় কী রাখা যায়, তাই প্রতিটি অ্যাপের জন্য আলাদা কী ব্যবহার করুন। কী শুধু একবার দেখানো হয় এবং শুধু হ্যাশ হিসেবে সংরক্ষিত থাকে, তাই সঙ্গে সঙ্গে কপি করুন। হারিয়ে গেলে বাতিল করে নতুন কী তৈরি করুন।
যা কল করা যায়
আপনার কী ও একটি action সহ https://yooz.market/api/v1 ঠিকানায় JSON (বা ফর্ম) অনুরোধ পাঠান।
- balance: আপনার ওয়ালেট ব্যালেন্স।
- services: অর্ডারযোগ্য সার্ভিস, সর্বনিম্ন/সর্বোচ্চ ও প্রতি ইউনিটের রেটসহ।
- add: সার্ভিস, লিংক ও পরিমাণ (এবং প্রয়োজনে রিয়্যাকশন) দিয়ে অর্ডার করা।
- status: আইডি দিয়ে অর্ডারের অবস্থা।
- getCountries: স্টকে ভার্চুয়াল নম্বর আছে এমন দেশ এবং একটি নম্বরের দাম।
- getNumber: country_code দিয়ে নম্বর কেনা; নম্বর ও order_id ফেরত দেয়।
- getCode: কেনা নম্বরের লগইন কোড, অথবা waiting।
বিলিং, রিট্রাই ও রিফান্ড
API অর্ডারের টাকা ড্যাশবোর্ডের একই দামে ওয়ালেট থেকে কাটা হয় এবং ব্যর্থ অর্ডার স্বয়ংক্রিয়ভাবে ফেরত যায়। add বা getNumber-এ ঐচ্ছিক idempotency_key দিন, যাতে রিট্রাই কখনও দ্বিতীয় অর্ডার তৈরি না করে। ত্রুটি status "error" ও message_error ফিল্ডসহ ফেরত আসে।
কী বাতিল করা
একই পেজ থেকে কী বাতিল করুন; যা কিছু সেটি ব্যবহার করছিল তা সঙ্গে সঙ্গে বন্ধ হয়ে যায়। এটি ফেরানো যায় না, তাই প্রতি অ্যাপে আলাদা কী রাখা কাজের।