Разработчики | 💋ᒪOᐯEᑕOᑎᑎEᑕT💋

Версия API 1.1

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

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

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

Вам нужно создать новое приложение Создать новое приложение
Как только вы создадите свое приложение, вы получите app_id и app_secret

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

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

Запуск процесса входа в OAuth, вам нужно использовать ссылку для вашего приложения, как это:
```
<a href="https://stalkerqw.ru/api/oauth?app_id=YOUR_APP_ID">Log in With 💋ᒪOᐯEᑕOᑎᑎEᑕT💋</a>
```
Пользователь будет перенаправлен на вход с такой же страницей
Как только пользователь получит доступ к вашему приложению, пользователь будет перенаправлен на ваш URL-адрес приложения с auth_key нравится это:
```
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
```
Это auth_key действителен только за разовое использование, так что после использования вы не сможете использовать его снова и сгенерировать новый код, вам нужно будет перенаправить пользователя на вход со ссылкой еще раз.

Маркер доступа

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

Чтобы получить токен доступа, сделайте 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://stalkerqw.ru/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 часа, так что как он станет недействительным, вам нужно genarte новый через перенаправление пользователя на вход со ссылкой снова.

API

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

Endpoint	Описание
api/get_user_info	получить информацию о пользователе

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

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