Версия API 1.1

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

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

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

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

Вход в систему

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

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

   <a href="https://hiitsme.ru/api/oauth?app_id=YOUR_APP_ID">Log in With Hi its me</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://hiitsme.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 часа, поэтому после того, как он станет недействительным, вам нужно будет переписать новый, перенаправив пользователя на страницу входа снова по ссылке.

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

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

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

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