Разработчики

Изучите инструменты для разработчиков, которые мы предлагаем

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

Версия API 1.1

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

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

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

Войти через

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

  1. 1 Чтобы начать вход через OAuth, используйте в приложении ссылку такого вида:
    HTML
    <a href="https://www.flexartsocial.com/api/oauth?app_id=YOUR_APP_ID">Log in With flexartsocial.com</a>
    Пользователь будет перенаправлен на страницу входа такого вида
  2. 2 Когда пользователь разрешит доступ вашему приложению, он будет перенаправлен на URL перенаправления приложения с параметром auth_key такого вида:
    URL
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Учтите: auth_key действует только один раз. После использования его нельзя применить повторно; чтобы получить новый код, снова перенаправьте пользователя по ссылке входа.

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

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

Чтобы получить токен доступа, отправьте HTTP GET-запрос на следующий эндпоинт:
PHP
<?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://www.flexartsocial.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));
}

// 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 действует только 1 час. Когда срок истечёт, получите новый, снова перенаправив пользователя по ссылке входа.

API

Получив access_token вы можете запрашивать данные из нашей системы с помощью HTTP GET-запросов со следующими параметрами

GET /api/get_user_info получить информацию о пользователе
Получить информацию о пользователе можно так
PHP
if (!empty($json['access_token'])) {
  $access_token = $json['access_token']; // your access token
  $get = file_get_contents("https://www.flexartsocial.com/api/get_user_info?access_token=$access_token");
}
Результат:
JSON
{
  "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": ""
  }
}