Версия API 1.1

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

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

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

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

Войдите в систему с помощью

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

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

   <a href="https://vintfint.com/api/oauth?app_id=YOUR_APP_ID">Log in With VintFint</a>

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

   
2. Как только пользователь примет ваше приложение, он будет перенаправлен на URL-адрес App Redirect с 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
   
               $get = file_get_contents("https://vintfint.com/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://vintfint.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": ""
              }
            }