เวอร์ชัน API 1.1

เอกสารนี้จะอธิบายวิธีลงทะเบียน กําหนดค่า และพัฒนาแอปของคุณ เพื่อให้คุณสามารถใช้ API ของเราได้สําเร็จ

สร้างแอป

เพื่อให้แอปของคุณเข้าถึง API ของเรา คุณต้องลงทะเบียนแอปของคุณโดยใช้ แดชบอร์ดแอป. การลงทะเบียนจะสร้างรหัสแอปที่แจ้งให้เราทราบว่าคุณเป็นใคร ช่วยให้เราแยกแยะแอปของคุณจากแอปอื่นๆ.

1. คุณจะต้องสร้างแอพใหม่ สร้างแอปใหม่
2. เมื่อคุณสร้างแอพของคุณแล้วคุณจะได้รับ app_id และ app_secret

เข้าสู่ระบบด้วย

เข้าสู่ระบบด้วยระบบเป็นวิธีที่รวดเร็วและสะดวกสําหรับผู้คนในการสร้างบัญชีและลงชื่อเข้าใช้แอปของคุณ ระบบ Log in With ของเราเปิดใช้งานสองสถานการณ์คือการรับรองความถูกต้องและการขอสิทธิ์ในการเข้าถึงข้อมูลของผู้คน คุณสามารถใช้ระบบ Login With เพียงเพื่อการตรวจสอบสิทธิ์หรือสําหรับทั้งการรับรองความถูกต้องและการเข้าถึงข้อมูล.

1. เริ่มกระบวนการเข้าสู่ระบบ OAuth คุณต้องใช้ลิงก์สําหรับแอปของคุณเช่นนี้:

   <a href="https://www.9020blog.com/board/api/oauth?app_id=YOUR_APP_ID">Log in With Hot166 Community</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://www.9020blog.com/board/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 ซึ่งรองรับพารามิเตอร์ต่อไปนี้:

คุณสามารถ retrive ข้อมูลผู้ใช้เช่นนี้

if(!empty($json['access_token'])) {
       $access_token = $json['access_token']; // your access token
       $get = file_get_contents("https://www.9020blog.com/board/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": ""
        }
    }