גרסת WP 1.1

תיעוד זה מסביר כיצד לרשום, להגדיר ולפתח את האפליקציה שלך כדי שתוכל להשתמש בהצלחה בממשקי Api שלנו

צור אפליקציה

כדי שהאפליקציה שלך תוכל לגשת לממשקי ה- API שלנו, עליך לרשום את האפליקציה באמצעות לוח בקרת אפליקציות. ההרשמה יוצרת מזהה App שמאפשר לנו לדעת מי אתה, עוזר לנו להבדיל את האפליקציה שלך מיישומים אחרים.

1. יהיה עליך ליצור יישום חדש צור אפליקציה חדשה
2. לאחר שיצרת את האפליקציה שלך תקבל את ה app_id ו app_secret

התחבר עם

התחבר עם המערכת היא דרך מהירה ונוחה עבור אנשים ליצור חשבונות להיכנס ליישום שלך. מערכת הכניסה למערכת מאפשרת לשני תרחישים, לבצע אימות ולבקש הרשאות גישה לנתונים של אנשים. באפשרותך להשתמש בכניסה למערכת רק לצורך אימות או עבור אימות וגישה לנתונים.

1. הפעלת תהליך הכניסה של OAuth, אתה צריך להשתמש בקישור עבור האפליקציה שלך כמו זה:

   <a href="https://freetalks.live/api/oauth?app_id=YOUR_APP_ID">Log in With Freetalks - דבר חופשי</a>

   המשתמש ינתב מחדש לכניסה עם דף כזה

   
2. לאחר שהמשתמש אישר האפליקציה שלך, המשתמש יופנה אל כתובת ה-URL שלך App ניתוב מחדש עם auth_key כמו זה:

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

   זה auth_key תקף לשימוש חד פעמי בלבד, כך שברגע שהשתמשת בו לא תוכל להשתמש בו שוב וליצור קוד חדש תצטרך להפנות את המשתמש לכניסה עם קישור שוב.

אסימון גישה

ברגע שאתה מקבל את אישור המשתמש של האפליקציה שלך כניסה עם חלון וחזר עם ה auth_key מה שאומר שעכשיו אתה מוכן לאחזר נתונים מAPIs שלנו ולהתחיל את התהליך הזה תצטרך לאשר את האפליקציה שלך ולקבל את ה 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://freetalks.live/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 תקף רק לשעה אחת בלבד, אז ברגע שזה נעשה לא חוקי תצטרך genarte חדש אחד על ידי ניתוב מחדש של המשתמש להיכנס עם קישור שוב.

APIs

ברגע שאתה מקבל את access_token עכשיו אתה יכול לאחזר ידיעות מהמערכת שלנו באמצעות HTTP GET בקשות אשר תומך בפרמטרים הבאים

אתה יכול לאחזר מידע משתמש כמו זה

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