เวอร์ชัน API 1.1
เอกสารนี้อธิบายวิธีการลงทะเบียน กำหนดค่า และพัฒนาแอปของคุณ เพื่อให้คุณสามารถใช้ API ของเราได้สำเร็จ
สร้างแอพ
เพื่อให้แอปของคุณเข้าถึง API ของเรา คุณต้องลงทะเบียนแอปของคุณโดยใช้ แดชบอร์ดของแอป. การลงทะเบียนสร้าง App ID ที่ทำให้เรารู้ว่าคุณเป็นใคร ช่วยให้เราแยกแยะแอพของคุณจากแอพอื่นๆ.
- คุณจะต้องสร้างแอปใหม่ สร้างแอพใหม่
- เมื่อคุณสร้างแอปของคุณแล้ว คุณจะได้รับ app_id และ app_secret
เข้าสู่ระบบด้วย
การเข้าสู่ระบบด้วยระบบเป็นวิธีที่รวดเร็วและสะดวกสำหรับผู้คนในการสร้างบัญชีและลงชื่อเข้าใช้แอปของคุณ ระบบ Log in With ของเราเปิดใช้งานสองสถานการณ์ การตรวจสอบสิทธิ์และการขอสิทธิ์ในการเข้าถึงข้อมูลของผู้คน คุณสามารถใช้การเข้าสู่ระบบด้วยระบบเพื่อการตรวจสอบสิทธิ์หรือทั้งการตรวจสอบสิทธิ์และการเข้าถึงข้อมูล.
-
เริ่มต้นกระบวนการเข้าสู่ระบบ OAuth คุณต้องใช้ลิงก์สำหรับแอปของคุณในลักษณะนี้:
<a href="https://ifvex.com/api/oauth?app_id=YOUR_APP_ID">Log in With Ifvex</a>
ผู้ใช้จะถูกเปลี่ยนเส้นทางไปยังหน้า Log in With แบบนี้
-
เมื่อผู้ใช้ยอมรับแอปของคุณแล้ว ผู้ใช้จะถูกเปลี่ยนเส้นทางไปยัง URL การเปลี่ยนเส้นทางแอปของคุณด้วย auth_key อย่างนี้:
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
นี้ auth_key ใช้ได้เพียงครั้งเดียว ดังนั้นเมื่อคุณใช้ไปแล้ว คุณจะไม่สามารถใช้งานได้อีก และสร้างรหัสใหม่ คุณจะต้องเปลี่ยนเส้นทางผู้ใช้ไปยังการเข้าสู่ระบบด้วยลิงก์อีกครั้ง.
เข้าสู่ Token
เมื่อคุณได้รับการอนุมัติจากผู้ใช้แอปของคุณ เข้าสู่ระบบด้วยหน้าต่างและกลับมาพร้อมกับ auth_key ซึ่งหมายความว่าตอนนี้คุณพร้อมที่จะดึงข้อมูลจาก API ของเราแล้ว และเพื่อเริ่มกระบวนการนี้ คุณจะต้องอนุญาตแอปของคุณและรับ access_token และคุณสามารถทำตามขั้นตอนของเราเพื่อเรียนรู้วิธีรับ.
-
หากต้องการรับโทเค็นการเข้าถึง ให้ส่งคำขอ 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://ifvex.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 ชั่วโมงเท่านั้น ดังนั้นเมื่อไม่ถูกต้อง คุณจะต้องสร้างใหม่โดยเปลี่ยนเส้นทางผู้ใช้ไปยังการเข้าสู่ระบบด้วยลิงก์อีกครั้ง.
API
เมื่อคุณได้รับของคุณ access_token ตอนนี้คุณสามารถดึงข้อมูลจากระบบของเราผ่านการร้องขอ HTTP GET ซึ่งรองรับพารามิเตอร์ต่อไปนี้
จุดสิ้นสุด | รายละเอียด |
---|---|
api/get_user_info |
รับข้อมูลผู้ใช้ |
คุณสามารถดึงข้อมูลผู้ใช้เช่นนี้
if(!empty($json['access_token'])) { $access_token = $json['access_token']; // your access token $get = file_get_contents("https://ifvex.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": "" } }