Local

Розробники

Дослідіть інструменти розробника, які ми пропонуємо

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

Версія API 1.1

Створити додаток

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

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

Увійти через

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

  1. 1 Починаючи процес входу OAuth, вам потрібно використати для свого додатка посилання такого вигляду:
    HTML
    <a href="https://local.vn.ua/api/oauth?app_id=YOUR_APP_ID">Log in With Local</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://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-запити, які підтримують такі параметри

GET /api/get_user_info отримати інформацію про користувача
Ви можете отримати інформацію про користувача так
PHP
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");
}
Результат буде:
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": ""
  }
}