API Sürümü 1.1

Bu dokümantasyon, API'lerimizi başarıyla kullanabilmeniz için uygulamanızı nasıl kaydedeceğinizi, yapılandıracağınızı ve geliştireceğinizi açıklar

Uygulama Oluştur

Uygulamanızın API'lerimize erişebilmesi için, uygulamanızı şunu kullanarak kaydetmelisiniz Uygulama Panosu. Kayıt, kim olduğunuzu bilmemizi sağlayan ve uygulamanızı diğer uygulamalardan ayırmamıza 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 şunları alacaksınız: app_id ve app_secret

Şununla Giriş Yap

Giriş Yap sistemi, insanların hesap oluşturması ve uygulamanıza giriş yapması için hızlı ve kullanışlı bir yoldur. Giriş Yap sistemimiz iki senaryoyu mümkün kılar: kimlik doğrulama ve kişilerin verilerine erişmek için izin isteme. Giriş Yap sistemini yalnızca kimlik doğrulama için veya hem kimlik doğrulama hem de veri erişimi için kullanabilirsiniz..

1. OAuth giriş sürecini başlatırken, uygulamanız için şöyle 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ı şu şekilde bir Giriş Yap sayfasına yönlendirilecek

   
2. Kullanıcı uygulamanızı kabul ettikten sonra, uygulama yönlendirme URL'nize şu şekilde yönlendirilecektir: auth_key bunu beğen:

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

   Bu auth_key yalnızca bir kez kullanım için geçerlidir, bu nedenle kullandıktan sonra tekrar kullanamazsınız ve yeni kod oluşturmak için kullanıcıyı tekrar bağlantıyla giriş yapmaya yönlendirmeniz gerekir.

Erişim Belirteci

Uygulamanızın 'Şununla Oturum Aç' penceresinde kullanıcı onayını aldıktan ve şununla döndükten sonra: auth_key which means that now you are ready to retrive data from our APIs and to start this process you will need to authorize your app and get the access_token ve nasıl alacağınızı öğrenmek için adımlarımızı takip edebilirsiniz.

1. Erişim tokeni almak için aşağıdaki uç noktaya şu şekilde 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 1 saat için geçerlidir, bu nedenle geçersiz olduğunda kullanıcıyı tekrar bağlantıyla giriş yapmaya yönlendirerek yeni bir tane oluşturmanız gerekir.

API'ler

Şunları aldıktan sonra: access_token Artık sistemimizden aşağıdaki parametreleri destekleyen HTTP GET istekleriyle 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://www.motoclup.com/api/get_user_info?access_token=$access_token");
        }
        

Sonuç şu olacak:

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