Версия API 1.1

В этой документации объясняется, как зарегистрировать, настроить и разработать ваше приложение, чтобы вы могли успешно использовать наши API

Создать приложение

Чтобы ваше приложение получило доступ к нашим API, вам необходимо зарегистрировать его с помощью Дашборд приложения. Регистрация создает идентификатор приложения, который позволяет нам узнать, кто вы, и помогает нам отличать ваше приложение от других приложений.

1. Вам нужно будет создать новое приложение Создать новое приложение
2. После того, как вы создали свое приложение, вы получите app_id и app_secret

Войти через

Система «Войти через» — это быстрый и удобный способ создания аккаунтов и входа в ваше приложение. Наша система «Войти через» поддерживает два сценария: аутентификацию и запрос разрешения на доступ к данным пользователей. Вы можете использовать систему «Войти через» как для аутентификации, так и для доступа к данным.

1. Для запуска процесса входа в OAuth вам необходимо использовать ссылку для вашего приложения, например, такую::

   <a href="https://realixia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Мультивселенная соцсеть REALIXIA</a>

   Пользователь будет перенаправлен на страницу «Войти через» следующим образом:

   
2. Как только пользователь примет ваше приложение, он будет перенаправлен на URL вашего приложения с auth_key как это:

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

   Это auth_key действителен только для одноразового использования, поэтому, как только вы его использовали, вы не сможете использовать его снова и сгенерировать новый код, вам нужно будет снова перенаправить пользователя на страницу входа по ссылке.

Токен доступа

Как только вы получите одобрение пользователя вашего приложения, войдите в окно «Войти через» и вернитесь с auth_key Это означает, что теперь вы готовы извлекать данные из наших API, и чтобы начать этот процесс, вам необходимо авторизовать свое приложение и получить access_token и вы можете следовать нашим шагам, чтобы узнать, как это сделать.

1. Чтобы получить токен доступа, отправьте HTTP-запрос GET к следующей конечной точке следующим образом::

   <?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://realixia.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
   }
   ?>
   

   Это access_token действителен только в течение одного часа, поэтому, как только он станет недействительным, вам нужно будет сгенерировать новый, перенаправив пользователя на страницу входа по ссылке еще раз.

API

Как только вы получите access_token Теперь вы можете получать информацию из нашей системы с помощью HTTP GET-запросов, которые поддерживают следующие параметры:

Вы можете получить информацию о пользователе следующим образом:

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

Результат будет:

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