Авторизация пользователей через внешний токен
Добро пожаловать на страницу, посвященную авторизации пользователей в API мобильной игры “Шарики” (Crazy Balls) с использованием внешних токенов. Эта система обеспечивает безопасный и надежный доступ к функционалу нашего API, позволяя разработчикам интегрировать “Шарики” в свои приложения и сервисы.
Что такое внешний токен?
Внешний токен – это уникальный идентификатор, который используется для аутентификации пользователя без необходимости передачи его пароля напрямую. Это значительно повышает безопасность вашего приложения и защищает пользовательские данные от несанкционированного доступа. Наш API использует систему токенов, базирующуюся на стандарте OAuth 2.0, что гарантирует высокую надежность и соответствие современным стандартам безопасности.
Как получить внешний токен?
Процесс получения внешнего токена состоит из нескольких шагов:
- Регистрация приложения: Перед началом работы вам необходимо зарегистрировать ваше приложение на нашем портале разработчиков crazy-balls.ru/developers. При регистрации вам потребуется указать название вашего приложения, его описание и назначение. После успешной регистрации вы получите уникальный идентификатор приложения (Client ID) и секретный ключ (Client Secret).
- Запрос кода авторизации: На этом этапе ваше приложение направляет пользователя на страницу авторизации Crazy Balls. После успешного входа пользователь предоставляет вашему приложению разрешение на доступ к своим данным. В результате этого шага ваше приложение получает код авторизации.
- Обмен кода авторизации на токен: Используя полученный код авторизации, Client ID и Client Secret, ваше приложение отправляет запрос на наш сервер авторизации. В ответ сервер возвращает внешний токен доступа и, возможно, токен обновления (refresh token).
- Использование токена: Полученный токен доступа используется для аутентификации всех последующих запросов к API Crazy Balls. Токен обновления позволяет получать новые токены доступа, не требуя повторной авторизации пользователя.
Типы токенов и их срок действия
Мы используем два типа токенов: токены доступа (access tokens) и токены обновления (refresh tokens). Токены доступа имеют ограниченный срок действия (например, 1 час), после чего становятся недействительными. Токены обновления позволяют получать новые токены доступа без необходимости повторной авторизации пользователя. Срок действия токенов обновления значительно больше (например, 30 дней).
Обработка ошибок
При возникновении ошибок при авторизации или использовании API, наш сервер возвращает соответствующие коды ошибок и описания. Подробная документация по кодам ошибок доступна на странице crazy-balls.ru/developers/error-codes.
Примеры запросов
Ниже приведены примеры запросов к API Crazy Balls с использованием внешних токенов.
Получение информации о профиле пользователя
GET https://api.crazy-balls.ru/v1/users/profile?access_token=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
Получение списка друзей пользователя
GET https://api.crazy-balls.ru/v1/users/12345/friends?access_token=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
Отправка сообщения другу
POST https://api.crazy-balls.ru/v1/messages?access_token=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
В теле запроса необходимо передать данные сообщения, включая ID получателя (например, “recipient_id”: 67890).
Безопасность
Безопасность ваших данных является нашим приоритетом. Мы используем современные методы шифрования и аутентификации для защиты ваших токенов и пользовательских данных. Храните ваши Client ID, Client Secret и токены доступа в надежном месте и не передавайте их третьим лицам.
Поддержка
Если у вас возникли вопросы или проблемы с авторизацией или использованием API, пожалуйста, обратитесь в нашу службу поддержки по адресу info@crazy-balls.ru. Мы всегда готовы помочь!
Цены на использование API
Использование нашего API предоставляется по подписному плану. Стоимость подписки зависит от объема запросов и функциональности, к которой вы получаете доступ:
- Базовый план: 10 000 запросов в месяц – 999 рублей.
- Премиум план: 100 000 запросов в месяц – 9999 рублей.
- Корпоративный план: Индивидуальное предложение – обратитесь в нашу службу поддержки для уточнения деталей.
Обратите внимание, что указанные цены являются ориентировочными и могут быть изменены. Более подробную информацию о ценах и условиях использования API вы можете найти на нашем сайте.
Дополнительные возможности API
Наш API предоставляет широкий спектр функций, включая:
- Управление профилем пользователя
- Доступ к списку друзей
- Отправка и получение сообщений
- Интеграция с рейтинговой системой
- Доступ к статистике игры
- И многое другое!
Полную документацию по API вы можете найти на странице crazy-balls.ru/developers/api-documentation.
Мы постоянно работаем над улучшением и расширением функциональности нашего API, чтобы предоставить разработчикам все необходимые инструменты для создания успешных приложений.