Приложения и игры: обзор

Приложение — это ваш сайт, который открывается внутри страницы Апельсинки в iframe. Мы передаём ему, кто его открыл, и даём API для друзей, фото, ленты, хранилища и платежей. Хостинг — ваш; мы ничего не размещаем.

Как это устроено

1. Вы регистрируете приложение в кабинете разработчика: название, адрес (только https), размер iframe, права, адрес колбэков платежей. Получаете application_key и application_secret.
2. Пользователь открывает http://apelsinki.com/app/{slug}, устанавливает приложение (соглашается с правами) — страница показывает iframe контейнера http://apps.apelsinki.com/run/{id}, а тот — iframe на ваш адрес с подписанными параметрами.
3. Ваша страница проверяет подпись, узнаёт viewer_id и работает. Методы API вызываются с вашего сервера или прямо из браузера через клиентскую библиотеку.
4. Пока приложение не опубликовано, его видите вы и тестировщики. Отправьте на модерацию — после проверки оно появится в каталоге игр или приложений.

Права (permissions)

Право на профиль (1) даётся всегда. Остальные пользователь видит при установке; текущая маска приходит в параметре permissions.

Ограничения

• 30 вызовов API в секунду на приложение.
• Приглашения: не более 20 в сутки от одного пользователя; только друзьям, у которых приложения ещё нет.
• Публикации в ленту: 5 в сутки на пользователя; достижения: 3.
• Хранилище: ключ до 64 символов, значение до 64 КБ.
• Сессия пользователя живёт 24 часа, затем контейнер выдаст новую.

Совместимость с Internet Explorer 5.5+

Часть аудитории Апельсинки пользуется очень старыми браузерами. Если ваше приложение обходится без Flash, canvas и современного JS, отметьте «работает в IE 5.5+» в настройках — оно получит отметку в каталоге. Клиентская библиотека работает в IE 5.5 (JSONP вместо XHR).