API Sürümü 1.1

Bu dokümantasyon, API'lerimizi başarılı bir şekilde 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ı şurayı kullanarak kaydetmelisiniz: Uygulama Paneli. Kayıt, kim olduğunuzu bilmemizi sağlayan 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 şunları alacaksınız: app_id ve app_secret

Şununla Giriş Yap

'Şununla Giriş Yap' sistemi, insanların hesap oluşturması ve uygulamanıza giriş yapması için hızlı ve uygun bir yoldur. 'Şununla Giriş Yap' sistemimiz iki senaryoyu mümkün kılar: kimlik doğrulama ve insanların verilerine erişim izni isteme. Giriş Yap sistemini sadece kimlik doğrulama için veya hem kimlik doğrulama hem de veri erişimi için kullanabilirsiniz.

1. OAuth giriş sürecini başlatmak için, uygulamanız için şunun gibi bir link kullanmanız gerekir:

   <a href="https://iridaa.com/api/oauth?app_id=YOUR_APP_ID">Log in With İridaa</a>

   Kullanıcı şu şekilde 'Şununla Giriş Yap' sayfasına yönlendirilecektir

   
2. Kullanıcı uygulamanızı kabul ettikten sonra, şu parametre ile Uygulama Yönlendirme URL'nize yönlendirilecektir: auth_key bunun gibi:

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

   Bu auth_key sadece tek seferlik kullanım için geçerlidir, bu yüzden kullandıktan sonra tekrar kullanamazsınız ve yeni kod oluşturmak için kullanıcıyı tekrar giriş linkine yönlendirmeniz gerekecektir.

Erişim Jetonu

Uygulamanızın 'Şununla Giriş Yap' penceresinden kullanıcı onayı alıp şu parametre ile döndüğünde: auth_key bu artık API'lerimizden veri çekmeye hazır olduğunuz anlamına gelir ve bu süreci başlatmak için uygulamanızı yetkilendirmeniz ve şunu almanız gerekecektir: access_token ve nasıl alacağınızı öğrenmek için adımlarımızı takip edebilirsiniz.

1. Bir erişim jetonu almak için, aşağıdaki bitiş noktasına ş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://iridaa.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 sadece 1 saat geçerlidir, bu yüzden geçersiz olduğunda kullanıcıyı tekrar giriş linkine yönlendirerek yeni bir tane oluşturmanız gerekecektir.

API'ler

Şunu aldığınızda: access_token Artık aşağıdaki parametreleri destekleyen HTTP GET istekleri ile sistemimizden bilgi alabilirsiniz

Kullanıcı bilgisini şu şekilde alabilirsiniz

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

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