API Sürümü 1.1

Bu belgelerde, apı'lerimizi başarıyla kullanabilmeniz için uygulamanızın nasıl kaydedileceği, yapılandırılacağı ve geliştirileceği açıklanmaktadır

Uygulama Oluştur

Uygulamanızın apı'lerimize erişebilmesi için, uygulamanızı kullanarak kaydolmanız gerekir. Uygulama Kontrol Paneli. Kayıt, kim olduğunuzu bize bildiren ve uygulamanızı diğer uygulamalardan ayırt etmemize yardımcı olan bir Uygulama Kimliği oluşturur.

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

İle giriş yap

Sistemle giriş yapmak, kişilerin hesap oluşturması ve uygulamanıza giriş yapması için hızlı ve kullanışlı bir yoldur. Sistemle oturum açmamız, kimlik doğrulama ve kişilerin verilerine erişmek için izinler isteme olmak üzere iki senaryo sağlar. Sistemle Oturum açmayı yalnızca kimlik doğrulama veya hem kimlik doğrulama hem de veri erişimi için kullanabilirsiniz.

1. OAuth oturum açma işlemini başlattığınızda, uygulamanız için bunun gibi bir bağlantı kullanmanız gerekir:

   <a href="https://www.motoclup.com/api/oauth?app_id=YOUR_APP_ID">Log in With MotoClup - Motosiklet Tutkunlarının Sosyal Platformu</a>

   Kullanıcı böyle bir sayfa ile giriş yapmak için yönlendirilecektir

   
2. Kullanıcı uygulamanıza eriştikten sonra, kullanıcı Uygulamanızın Yönlendirme URL'sine şu adresle yönlendirilir: auth_key bunun gibi:

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

   Bu auth_key yalnızca bir kerelik kullanım için geçerlidir, bu nedenle bir kez kullandıktan sonra tekrar kullanamazsınız ve yeni kod oluşturamazsınız, kullanıcıyı tekrar oturum aç bağlantısına yönlendirmeniz gerekir.

Erişim Belirteci

Uygulamanızın kullanıcı onayını aldıktan sonra Pencere ile giriş yapın ve auth_key bu, artık apı'lerimizden veri almaya hazır olduğunuz anlamına gelir ve bu işlemi başlatmak için uygulamanızı yetkilendirmeniz ve access_token ve nasıl elde edeceğinizi öğrenmek için adımlarımızı takip edebilirsiniz.

1. Bir erişim belirteci almak için aşağıdaki uç noktaya aşağıdaki gibi bir HTTP GET isteği yapın:

           <?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://www.motoclup.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 bir 1 saat geçerlidir, bu nedenle geçersiz hale geldiğinde, kullanıcıyı tekrar giriş bağlantısına yönlendirerek yenisini oluşturmanız gerekir.

API'ler

Bir kez sen almak senin access_token Artık aşağıdaki parametreleri destekleyen HTTP GET istekleri aracılığıyla sistemimizden bilgi alabilirsiniz

Kullanıcı bilgilerini şu şekilde geri alabilirsiniz

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

Sonuç şöyle 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": ""
          }
        }