API sürümü 1.1

Bu belgeler, API’lerimizi kullanmak için uygulamanı nasıl kaydedeceğini, yapılandıracağını ve geliştireceğini anlatır

App oluştur

Uygulamanın API’lerimize erişmesi için şunu kullanarak kaydetmelisin Uygulama paneli. Kayıt, kim olduğunu gösteren ve uygulamanı diğerlerinden ayıran bir App ID oluşturur.

1. Yeni bir uygulama oluşturman gerekir Yeni uygulama oluştur
2. Uygulamayı oluşturunca şunu alırsın app_id and app_secret

Şununla giriş yap

Şununla giriş sistemi, kişilerin hesabını hızlıca oluşturup uygulamanıza girmesini sağlar. İki senaryo vardır: kimlik doğrulama ve veri erişim izni. Yalnızca doğrulama veya hem doğrulama hem veri erişimi için kullanabilirsin.

1. OAuth girişini başlatmak için uygulaman için şöyle bir bağlantı kullan:

   <a href="https://sngine-app.fluttercrafters.com/api/oauth?app_id=YOUR_APP_ID">Log in With Sngine Flutter Crafters</a>

   Kullanıcı Şununla giriş sayfasına şöyle yönlendirilir

   
2. Kullanıcı uygulamanı kabul edince App Redirect URL’ine şununla yönlendirilir auth_key şöyle:

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

   Bu auth_key yalnızca bir kez geçerlidir; kullandıktan sonra yeni kod için kullanıcıyı tekrar giriş bağlantısına yönlendirmen gerekir.

Access Token

Kullanıcı Şununla giriş penceresinde onay verip şununla döndüğünde auth_key artık API’lerimizden veri almaya hazırsın; bunun için uygulamanı yetkilendirip şunu almalısın access_token ve nasıl alacağını adımlarımızdan öğrenebilirsin.

1. Access token almak için şu uç noktaya HTTP GET isteği yap, şö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://sngine-app.fluttercrafters.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; geçersiz olunca yeni tane için kullanıcıyı tekrar giriş bağlantısına yönlendir.

API'ler

Şunu aldıktan sonra access_token Artık şu parametreleri destekleyen HTTP GET istekleriyle sistemimizden bilgi alabilirsin

Kullanıcı bilgisini şöyle alabilirsin

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

Sonuç şöyle olur:

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