Версия API 1.1

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

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

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

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

Войти с помощью

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

1. Начиная процесс входа в OAuth, вы должны использовать ссылку для своего приложения, как это:

   <a href="https://sterh.app/api/oauth?app_id=YOUR_APP_ID">Log in With Sterh</a>

   Пользователь будет перенаправлен на страницу входа в систему, как это

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

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

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

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

Как только вы получите одобрение вашего приложения, войдите в систему в оконном режиме и вернитесь с auth_key это означает, что теперь вы готовы извлечь данные из наших APIs и начать этот процесс, вам нужно будет авторизовать ваше приложение и получить 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
   
                                                   $get = file_get_contents("https://sterh.app/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
   
                                                   $json = json_decode($get, true);
                                                   if(!empty($json['access_token'])) {
                                                       $access_token = $json['access_token']; // your access token
                                                   }
                                                   ?>                                                                                                
                                                                   

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

API-интерфейсы

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

Вы можете получить информацию о пользователе, как это

                                                if(!empty($json['access_token'])) {
                                                    $access_token = $json['access_token']; // your access token
                                                    $get = file_get_contents("https://sterh.app/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": ""
                                                  }
                                                }