Розробники
Дослідіть інструменти розробника, які ми пропонуємо
Ця документація пояснює, як зареєструвати, налаштувати та розробити свій додаток, щоб успішно використовувати наші API
Версія API 1.1Створити додаток
Щоб ваш додаток міг отримати доступ до наших API, ви повинні зареєструвати свій додаток за допомогою Панель додатків. Реєстрація створює ID додатка, який повідомляє нам, хто ви, і допомагає відрізнити ваш додаток від інших.
-
1
Вам потрібно буде створити новий додаток Створити новий додаток
-
2
Після створення додатка ви отримаєте свої
app_idтаapp_secret
Увійти через
Система «Увійти через» — це швидкий і зручний спосіб для людей створювати облікові записи та входити у ваш додаток. Наша система «Увійти через» підтримує два сценарії: автентифікацію та запит дозволів на доступ до даних людей. Ви можете використовувати систему «Увійти через» просто для автентифікації або як для автентифікації, так і для доступу до даних.
-
1
Починаючи процес входу OAuth, вам потрібно використати для свого додатка посилання такого вигляду:
Користувача буде перенаправлено на сторінку «Увійти через» такого виглядуHTML
<a href="https://local.vn.ua/api/oauth?app_id=YOUR_APP_ID">Log in With Local</a>
-
2
Після того як користувач прийме ваш додаток, його буде перенаправлено на URL перенаправлення вашого додатка з
auth_keyтакого вигляду:URLhttps://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEYЦеauth_keyдійсний лише для одноразового використання, тому після його використання ви не зможете використати його знову; щоб згенерувати новий код, вам потрібно буде знову перенаправити користувача на посилання «Увійти через».
Токен доступу
Після того як ви отримаєте схвалення користувача у вікні «Увійти через» вашого додатка і вам буде повернуто auth_key що означає, що тепер ви готові отримувати дані з наших API, і щоб почати цей процес, вам потрібно авторизувати свій додаток і отримати access_token і ви можете дотримуватися наших кроків, щоб дізнатися, як його отримати.
<?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://local.vn.ua/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-запити, які підтримують такі параметри
/api/get_user_info
отримати інформацію про користувача
if (!empty($json['access_token'])) {
$access_token = $json['access_token']; // your access token
$get = file_get_contents("https://local.vn.ua/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": ""
}
}