API সংস্করণ 1.1

এই ডকুমেন্টেশনটি ব্যাখ্যা করে যে কীভাবে আপনার অ্যাপ নিবন্ধন, কনফিগার এবং বিকাশ করবেন যাতে আপনি সফলভাবে আমাদের API ব্যবহার করতে পারেন

অ্যাপ তৈরি করুন

আপনার অ্যাপের জন্য আমাদের APIগুলি অ্যাক্সেস করার জন্য, আপনাকে অবশ্যই আপনার অ্যাপটি ব্যবহার করে নিবন্ধন করতে হবে অ্যাপ ড্যাশবোর্ড. নিবন্ধন একটি অ্যাপ আইডি তৈরি করে যা আমাদের জানতে দেয় আপনি কে, আমাদেরকে অন্যান্য অ্যাপ থেকে আপনার অ্যাপকে আলাদা করতে সাহায্য করে.

1. আপনাকে একটি নতুন অ্যাপ তৈরি করতে হবে নতুন অ্যাপ তৈরি করুন
2. একবার আপনি আপনার অ্যাপ তৈরি করলে আপনি পাবেন app_id এবং app_secret

দিয়ে লগ ইন করুন

লোকেদের অ্যাকাউন্ট তৈরি করতে এবং আপনার অ্যাপে লগ ইন করার জন্য সিস্টেমের সাথে লগ ইন করা একটি দ্রুত এবং সুবিধাজনক উপায়। আমাদের লগ ইন উইথ সিস্টেম দুটি পরিস্থিতিতে সক্ষম করে, প্রমাণীকরণ এবং লোকেদের ডেটা অ্যাক্সেস করার অনুমতি চাওয়া। আপনি শুধুমাত্র প্রমাণীকরণের জন্য অথবা প্রমাণীকরণ এবং ডেটা অ্যাক্সেস উভয়ের জন্যই লগইন উইথ সিস্টেম ব্যবহার করতে পারেন.

1. OAuth লগইন প্রক্রিয়া শুরু করে, আপনাকে এইভাবে আপনার অ্যাপের জন্য একটি লিঙ্ক ব্যবহার করতে হবে:

   <a href="https://bondhubook.com/api/oauth?app_id=YOUR_APP_ID">Log in With Bondhubook</a>

   ব্যবহারকারীকে এভাবে লগ ইন উইথ পেজে রিডাইরেক্ট করা হবে

   
2. একবার ব্যবহারকারী আপনার অ্যাপটি গ্রহণ করলে, ব্যবহারকারীকে আপনার অ্যাপ পুনঃনির্দেশ URL-এ পুনঃনির্দেশিত করা হবে auth_key এই মত:

   https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY

   এই auth_key শুধুমাত্র একবার ব্যবহারের জন্য বৈধ, তাই একবার আপনি এটি ব্যবহার করলে আপনি এটি আর ব্যবহার করতে পারবেন না এবং নতুন কোড তৈরি করতে আপনাকে ব্যবহারকারীকে আবার লিঙ্ক সহ লগ ইন করতে পুনঃনির্দেশ করতে হবে.

অ্যাক্সেস টোকেন

একবার আপনি আপনার অ্যাপের ব্যবহারকারীর অনুমোদন পেয়ে গেলে উইন্ডোর সাথে লগ ইন করুন এবং এর সাথে ফিরে আসেন auth_key যার মানে হল যে আপনি এখন আমাদের API গুলি থেকে ডেটা পুনরুদ্ধার করতে প্রস্তুত এবং এই প্রক্রিয়াটি শুরু করতে আপনাকে আপনার অ্যাপটিকে অনুমোদন করতে হবে এবং পেতে হবে access_token এবং কিভাবে এটি পেতে হয় তা জানতে আপনি আমাদের পদক্ষেপগুলি অনুসরণ করতে পারেন৷.

1. একটি অ্যাক্সেস টোকেন পেতে, এইভাবে নিম্নলিখিত শেষ পয়েন্টে একটি HTTP GET অনুরোধ করুন:

   <?php
   $app_id = "YOUR_APP_ID"; // your app id
   $app_secret = "YOUR_APP_SECRET"; // your app secret
   $auth_key = $_GET['auth_key']; // the returned auth key from previous step
   
   $get = file_get_contents("https://bondhubook.com/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
   
   $json = json_decode($get, true);
   if(!empty($json['access_token'])) {
       $access_token = $json['access_token']; // your access token
   }
   ?>

   এই access_token শুধুমাত্র মাত্র এক 1 ঘন্টার জন্য বৈধ, তাই একবার এটি অবৈধ হয়ে গেলে আপনাকে আবার লিঙ্কের সাথে লগ ইন করার জন্য ব্যবহারকারীকে পুনঃনির্দেশ করে নতুন তৈরি করতে হবে.

এপিআই

একবার আপনি আপনার পেতে access_token এখন আপনি HTTP GET অনুরোধের মাধ্যমে আমাদের সিস্টেম থেকে তথ্য পুনরুদ্ধার করতে পারেন যা নিম্নলিখিত পরামিতিগুলিকে সমর্থন করে৷

আপনি এই মত ব্যবহারকারীর তথ্য পুনরুদ্ধার করতে পারেন

if(!empty($json['access_token'])) {
   $access_token = $json['access_token']; // your access token
   $get = file_get_contents("https://bondhubook.com/api/get_user_info?access_token=$access_token");
}

ফলাফল হবে:

{
    "user_info": {
        "user_id": "",
        "user_name": "",
        "user_email": "",
        "user_firstname": "",
        "user_lastname": "",
        "user_gender": "",
        "user_birthdate": "",
        "user_picture": "",
        "user_cover": "",
        "user_registered": "",
        "user_verified": "",
        "user_relationship": "",
        "user_biography": "",
        "user_website": ""
    }
}