API Sürümü 1.1

Bu dokümantasyon, uygulamanızı kaydetme, yapılandırma ve geliştirme süreçlerini açıklayarak API’lerimizi başarıyla kullanmanızı sağlar

Uygulama Oluştur

Uygulamanızın API’lerimize erişebilmesi için uygulamanızı şu şekilde kaydetmeniz gerekir Uygulama Kontrol Paneli. Kayıt, sizin kim olduğunuzu anlamamızı sağlayan ve uygulamanızı diğerlerinden ayıran bir Uygulama Kimliği oluşturur.

1. Yeni bir Uygulama oluşturmanız gerekecek Yeni Uygulama Oluştur
2. Uygulamanızı oluşturduktan sonra şunları alacaksınız app_id ve app_secret

Şununla Giriş Yap

Log in With sistemi, insanların hızlı ve kolay şekilde hesap oluşturup uygulamanıza giriş yapmalarını sağlar. Bu sistem iki senaryo sunar: kimlik doğrulama ve kişilerin verilerine erişim izinlerinin istenmesi. Log in With sistemini yalnızca kimlik doğrulama için ya da hem kimlik doğrulama hem de veri erişimi için kullanabilirsiniz..

1. OAuth giriş sürecini başlatmak için uygulamanızda şu şekilde bir bağlantı kullanmanız gerekir:

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

   Kullanıcı bu şekilde Log in With sayfasına yönlendirilecektir

   
2. Kullanıcı uygulamanızı kabul ettikten sonra, kullanıcı şu bilgilerle uygulamanızın Yönlendirme URL'sine gönderilecektir auth_key böyle:

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

   Bu auth_key yalnızca bir kez kullanılabilir, bu yüzden bir kez kullandıktan sonra tekrar kullanamazsınız. Yeni kod oluşturmak için kullanıcıyı tekrar log in with bağlantısına yönlendirmeniz gerekir..

Erişim Jetonu

Uygulamanızın kullanıcı onayını aldıktan sonra Log in With penceresi şu bilgilerle döner auth_key bu, artık API’lerimizden veri almaya hazır olduğunuz ve bu süreci başlatmak için uygulamanızı yetkilendirip şu bilgiyi almanız gerektiği anlamına gelir access_token ve nasıl alacağınızı öğrenmek için adımlarımızı takip edebilirsiniz.

1. Erişim belirteci almak için şu uç noktaya HTTP GET isteği yapın, örneğin şöyle:

   <?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ızca 1 saat geçerlidir, bu nedenle süresi dolduğunda kullanıcıyı tekrar 'log in with' bağlantısına yönlendirerek yeni bir tane oluşturmanız gerekir..

API'ler

Şunları aldıktan sonra access_token Artık aşağıdaki parametreleri destekleyen HTTP GET istekleri ile sistemimizden bilgi alabilirsiniz.

Kullanıcı bilgilerini şu şekilde alabilirsiniz

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");
}

Sonuç şu şekilde olacaktır:

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