Версія API 1.0

Ця документація пояснює, як розробити, зареєструвати та налаштувати свій застосунок, щоб ви могли використовувати наші API

Створити застосунок

Щоб ваш застосунок міг отримати доступ до наших API, потрібно зареєструвати його за допомогою Панелі управління застосунками. Після реєстрації буде створено App ID, який допоможе нам ідентифікувати вас і відрізнити ваш застосунок від інших..

1. Вам потрібно створити новий застосунок Створити новий застосунок
2. Після створення застосунку, ви отримаєте свій app_id та app_secret.

Вхід за допомогою Fankolo

Наша система авторизації забезпечує швидкий та зручний спосіб для користувачів створювати облікові записи та входити у ваш застосунок. Вона підтримує два сценарії: автентифікація та запит дозволів на доступ до даних користувачів. Ви можете використовувати її лише для автентифікації або для автентифікації та доступу до даних..

1. Щоб розпочати процес входу через OAuth, скористайтеся посиланням такого вигляду:

   <a href="https://www.fankolo.com/api/oauth?app_id=YOUR_APP_ID">Вхід за допомогою Fankolo</a>

   Користувач буде перенаправлений на сторінку 'Вхід за допомогою Fankolo', яка виглядає так:

   
2. Після того, як користувач підтвердить вхід за допомогою вашого застосунку, він буде перенаправлений на ваш App Redirect URL з auth_key такого вигляду:

   https://yourdomain.com/your_redirect_url.php?auth_key=AUTH_KEY

   Цей auth_key дійсний лише для одноразового використання. Після використання вам потрібно буде перенаправити користувача на посилання для входу, щоб згенерувати новий.

Access Token

Після того, як користувач схвалить доступ вашого застосунку через вікно 'Вхід за допомогою Fankolo', ви отримаєте auth_key, та зможете отримувати дані з наших API. Щоб розпочати, потрібно авторизувати ваш застосунок та отримати access_token. Дотримуйтесь наступних кроків, щоб дізнатися, як отримати його.

1. Щоб отримати Access Token, зробіть HTTP GET запит до наступного Endpoint:
   api/authorize

   <?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://www.fankolo.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 дійсний лише протягом однієї години. Після закінчення його дії вам потрібно буде перенаправити користувача на посилання для входу, щоб згенерувати новий.

API

Після того, як ви отримали ваш access_token, ви можете отримувати інформацію з нашої системи за допомогою HTTP GET запитів, використовуючи такі параметри.

Ви можете отримати інформацію про користувача таким чином:

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

У разі помилки відповідь буде:

{
	"error":true,
	"message":"Error description"
}