API versiyası 1.1

Bu sənədləşmə API-lərimizdən uğurla istifadə etmək üçün tətbiqinizi necə qeydiyyatdan keçirməyi, konfiqurasiya etməyi və inkişaf etdirməyi izah edir

Tətbiq yarat

Tətbiqinizin API-lərimizə daxil ola bilməsi üçün tətbiqinizi istifadə edərək qeydiyyatdan keçirməlisiniz Tətbiq idarə paneli. Qeydiyyat sizin kim olduğunuzu bilməyimizə və tətbiqinizi digər tətbiqlərdən ayırmağımıza kömək edən Tətbiq ID-si yaradır.

1. Yeni bir tətbiq yaratmalısınız Yeni Tətbiq Yarat
2. Tətbiqinizi yaratdıqdan sonra əldə edəcəksiniz app_id və app_secret

Bununla daxil olun

Log in With sistemi insanların hesab yaratması və tətbiqinizə daxil olması üçün sürətli və rahat üsuldur. Bu sistem iki ssenarini dəstəkləyir: autentifikasiya və insanların məlumatlarına giriş icazəsinin alınması. Log in With sistemindən yalnız autentifikasiya üçün və ya həm autentifikasiya, həm də məlumat əldə etmək üçün istifadə edə bilərsiniz.

1. OAuth giriş prosesini başlatmaq üçün tətbiqinizdə bu kimi bir keçiddən istifadə etməlisiniz:

   <a href="https://girbir.com/api/oauth?app_id=YOUR_APP_ID">Log in With Girbir Sosyal Ağ</a>

   İstifadəçi bu şəkildə Log in With səhifəsinə yönləndiriləcək

   
2. İstifadəçi tətbiqinizi qəbul etdikdən sonra bu məlumatlarla Tətbiq yönləndirmə URL-nizə göndəriləcək auth_key bu şəkildə:

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

   Bu auth_key yalnız bir dəfə istifadə üçün keçərlidir, istifadə etdikdən sonra yenidən istifadə edə bilməzsiniz. Yeni kod yaratmaq üçün istifadəçini yenidən Log in With keçidinə yönləndirməlisiniz.

Giriş Tokeni

İstifadəçinin tətbiqinizə təsdiqini aldıqdan sonra Log in With pəncərəsi bu məlumatlarla geri qayıdır auth_key bu o deməkdir ki, artıq API-lərimizdən məlumat almağa hazırsınız və bu prosesi başlatmaq üçün tətbiqinizi icazələndirib aşağıdakı məlumatı əldə etməlisiniz access_token və onu necə əldə edəcəyinizi öyrənmək üçün addımlarımızı izləyə bilərsiniz.

1. Giriş tokeni əldə etmək üçün aşağıdakı son nöqtəyə bu şəkildə HTTP GET sorğusu göndərin:

           <?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
   
           // Prepare the POST data
           $postData = [
             'app_id' => $app_id,
             'app_secret' => $app_secret,
             'auth_key' => $auth_key
           ];
   
           // Initialize cURL
           $ch = curl_init('https://girbir.com/api/authorize');
   
           // Set cURL options for POST
           curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
           curl_setopt($ch, CURLOPT_POST, true);
           curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
   
           // Execute request
           $response = curl_exec($ch);
   
           // Check for cURL errors
           if (curl_errno($ch)) {
             die('cURL error: ' . curl_error($ch));
           }
   
           curl_close($ch);
   
           // Decode the JSON response
           $json = json_decode($response, true);
   
           // Use the access token if available
           if (!empty($json['access_token'])) {
             $access_token = $json['access_token']; // your access token
           }
           ?>
           

   Bu access_token yalnız 1 saat ərzində keçərlidir, müddəti bitdikdən sonra istifadəçini yenidən Log in With bağlantısına yönləndirərək yeni bir token yaratmalısınız.

API-lər

Əldə etdikdən sonra access_token İndi aşağıdakı parametrləri dəstəkləyən HTTP GET sorğuları vasitəsilə sistemimizdən məlumat əldə edə bilərsiniz

İstifadəçi məlumatlarını bu şəkildə əldə edə bilərsiniz

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

Nəticə belə olacaq:

        {
          "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": ""
          }
        }