Наверх

Разработчикам » Документация
Создание приложения
На базе платформы ВСети можно СОЗДАВАТЬ ПРИЛОЖЕНИЯ , относящиеся к одной следующих групп:

  • Игры и приложения для ВСети. Доступны для запуска внутри социальной сети и интегрируются внутри сайта при помощи Flash или IFrame -элемента. Этим приложениям доступно большинство методов API
Работа с API

изменения от 23 августа 2017 в 18:35
Краткий обзор взаимодействия Вашего приложения с нашим сайтом посредством api технологий.
Настройка доступа
Для настройки нового приложения вам придется знать параметры «ID приложения» и «Защищенный ключ» и в последствии вставить их в соответствующие переменные в файле in.php
$app_id = '4654396'; // id приложения
$api_secret = '1c37a99878c57fbbd335b319d926c2af'; // Ваш защитный код в приложении
Следующим шагом нам предстоит получить уникальный ID - пользователя для последующей инициализации его в приложении. Для этого при первом запуске приложения со стороны пользователя и в последующем Вам передается параметр:
$_GET['api_user_id']; // Уникальный идентификатор пользователя
Дальнейшим шагов Вы проводите соответствующую проверку данного пользователя у себя в базе данных и выводите информацию профиля или в случае отсутствия данных о пользователе у Вас в БД., создаете соответствующий запрос на получение данных методом приведенным ниже:
$data = $MYB->api('getProfiles', array('uids'=>$uid));
Где
$data //Переменная принимающая ответный результат
$uid //Уникальный идентификатор пользователя
getProfiles //Метод вызова информации о пользователе
Итог запроса мы приведем в примере:
$data['first_name'] // Имя пользователя
Итог: Максим
$data['last_name'] // Фамилия пользователя
Итог: Разин

Взаимодействие с API
Список методов
Для взаимодействия с интерфейсом приложения в браузере пользователя существует отдельная группа методов, выполняемых на стороне клиента. Эти методы позволяют инициировать, например, появление окна для запроса подтверждения от пользователя (оплата товара, размещение записи на стене и т.д.).
Схема вызова методов
Название метода и его параметры, если они требуются, необходимо передавать в качестве аргументов функции getProfiles. Процес вызова методов не разнится от вида приложение.
Список методов и подробный их разбор:
getProfiles
Запрос на вывод информации профиля пользователя запустившего приложение
$data = $MYB->api('getProfiles', array('uids'=>$uid));
Результат вызова метода:
$data['uid'] //ID пользователя
$data['first_name'] //Имя пользователя
$data['last_name'] // Фамилия пользователя
$data['sex'] //Пол человека 1-мужской 2-женский
$data['bdate'] //Год рождения
$data['rate'] //Рейтинг пользователя
$data['photo'] //Фотография
wall.post
Открывает окно для подтверждения пользователем публикации записи на стене. Вам при создании вызова данного метода требуется указать текст который будет добавлен пользователем на стену.
$data = $MYB->api('wall.post', array('uids'=>$uid, 'message' =>'Ваш текст', 'owner_id' =>$uid));
Код ошибки: 100
$error = $data['error']
$error['error_code']
secure.getAppBalance
Запрос баланса приложения
$data = $MYB->api('secure.getAppBalance', array('uids'=>'7'));
call.payment
Открывает окно для покупки товара в приложении или ввода голоса на счёт приложения. Требуется установка пакета разработчика pack_callback и дополнительные настройки приложения.
$data = $MYB->api('call.payment', array('uids'=>$uid, 'pay_text'=>'Описание услуги', 'number_product'=>'100', 'price'=>'22'));
Где
call.payment - метод вызова платежного окна
uids - Уникальный идентификатор пользователя
pay_text - Описание услуги или товара
number_product - Внутренний идентификатор продукта
price - Цена товара или услуги в голосах
call.invite.friends
Данный метод вызывает открытие окна на стороне пользователя с предложением пригласить в игру/приложение своих друзе.
$data = $MYB->api('call.invite.friends', array('uids'=>$uid));
Пример вызова метода
Способов вызова того или иного метода существует большое, разнообразное количество но мы решили привести Вам один, для общего понимания.
Обработчик:
if($_POST['call']){ $data = $MYB->api('getProfiles', array('uids'=>$uid)); }
Кнопка вызова:
<form name="test" method="post" action="in.php"><input type="submit" name="call" value="Вызвать метод"></form>
Системная ошибка
Так же существует код системной ошибки, который даст Вам понять, что Вы в процессе настройки пакета разработчика pack_developer допустили критические ошибки.
Код ошибки: 103
  • Выполнение запросов к API .
  • Процесс загрузки файлов на сервер ВСети

  • Платёжный API
    Обработка платежей
    Если Ваше приложение поддерживает финансовые операции то Вам в обязательном порядке надо будет реализовать следующие функции:
    Обработка платежных уведомлений
    Уведомления посылаются сервером платёжной системы на Адрес обратного вызова, указанный в настройках приложения, по протоколу HTTP или HTTPS, в зависимости от протокола указанного в адресе обратного вызова, методом GET в кодировке UTF-8.
    Чтобы исключить возможность подделки уведомления, уведомление подписывается секретным ключом, известным только владельцу приложения и платежной системе
    Разработчик приложения должен реализовать обработку уведомлений и вернуть результат обработки в случае успеха. При этом ответ должен быть отправлен в течение 10 секунд, иначе соединение будет разорвано, а попытка отправки уведомления будет предпринята еще раз через некоторое время.
    Внимание! Ответ должен быть в формате JSON в кодировке UTF-8.
    Код отправки обратного ответа в результате удачной обработки:
    $PAY_Result = array('pay'=>'successful');
    echo json_encode($PAY_Result);
    Настройка
    Вас следует указать секретный платежный пароль который указан в настройках приложения.
    $pay_code = 'Ваш платежный пароль';
    Пример:
    $pay_code = '4dcfe98190a677ec9bb30054c4ee0159';
    Параметры, указанные ниже отправляются в уведомлении при каждом запросе к Адресу обратного вызова
    $get_code = $_GET['pay_code'] //Платежный пароль
    $get_uids = $_GET['uids'] //Идентификатор пользователя, сделавшего заказ
    $get_number_product = $_GET['number_product'] //Идентификатор продукта
    $get_price = $_GET['price'] //Цена продукта
    Идентификатор продукта
    Уникальный идентификатор продукта за который пользователь пытается внести оплату.
  • Описание методов API – Список всех доступных методов API.
  • Ads API – Методы для работы с рекламным кабинетом.
  • Типы данных – описание типов данных, возвращаемых разными методами API.

  • Виджеты для сайтов

    Список виджетов:
    Другие разделы