เวอร์ชัน API 1.1

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

สร้างแอป

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

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

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

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

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

   <a href="https://www.hot166.com/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.hot166.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 ซึ่งรองรับพารามิเตอร์ต่อไปนี้:

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

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