ФЭНДОМ


Описание

Для удобства многих игроков, разработчиками EVE были созданы api для возможности доступа/рамещения информации об аккаунте, на других ресурсах.

Что такое ключ API? Как я могу использовать?

  • Ключ API является частным кодом, который идентифицирует ваш аккаунт и позволяет сторонним программам и веб-сайтам, получать доступ к информации о ваших персонажах и корпорациях. Используя эти данные, такие утилиты могут способствовать своевременному оповещению о важных для вас событиях, начиная от взаимодействия с игровым функционалом(продажи/календарные события/планы/состояние корабли и т.д.), заканчивая взаимодействием с другими игроками.

Это безопасно? Может ли кто-ни буть получить доступ к моей учетной записи без моего ведома?

  • Это безопасно, другие сайты и приложения получают доступ к информации о вашем аккаунте до тех пор пока вы даете на это согласие. Т.е. вы можете в любое время запретить данный доступ если сомневаетесь в безопасности ресурса, накотором предоставили свою информацию. Так же вы можете контролировать какая именно информация будет доступна другим пользователем, по тому ключу API что вы создали.
  • Использование ключа API не дает людям доступ к вашей учетной записи. В этом заключается цель ключей API. Ключ API позволяет только просматривать данные персонажа и корпорации. Они не смогут войти в игру или разместить на форуме сведения об API.

Это единственный безопасный способ дать программам и веб-сайтам доступ к вашим данным.

Я до сих пор не доверяю.

  • Если вы не уверены, что веб-сайт или программа, запрашиваемые ключ API, являются безопасными, пожалуйста, не предоставляйте ему ваш API ключ! Вы несете полную ответственность за любое использование информации, полученной с помощью функции API.

Я дал кому-то мой ключ API, и теперь я хочу, чтобы они не могли использовать его!

  • Если вы считаете, что кто-то злоупотребляет вашим ключом API, вы можете удалить его из списка разрешенных к доступу, или просто изменить код верификации. Пожалуйста, обратите внимание, что все программы и веб-сайты, которые используют старый API ключ, больше не будут иметь возможность получить доступ к данным, если вы не предоставите им новый ключ с обновленной информацией.

Вы можете просмотреть API активности на вашем счету с помощью журнала. API доступа Если вы считаете, что кто-то злоупотребляет одним из ваших ключей API, пожалуйста, измените код верификации или удалить ключ API из приведенного выше списка.

Как создать?

  1. Для того чтобы создать ключ перейдите по ссылке:

https://community.eveonline.com/support/api-key/update

  1. Вам необходимо будет авторизоваться.
Обратите внимание на адрес прежде чем авторизовываться. Только такой адрес является адресом ОФФ сайта.
  1. После авторизации у вас появиться окно с данной информацией:
АПИ1

АПИ2

АПИ3

где:

NameНазвание ключа
Typeтип ключа. Вы ожете выбрать на выбор ключ о персонаже(Character) или о корпорации(Corporation)
Characterданный пораметр позволяет ограничить ключ к доступу информации по одному вашиму персонажу или же сделать ключ на всех вместе.
Verification Codeслучайная последовательность букв и чисел, необходима при подключении ключа на др. ресурсах и приложениях, как система проверки(на подобии капи), что именно вы используете данный ключ а не кто-то еще.
Expiresсрок действия ключа. Если ставите галочку на No Expiry то ключ будет вечным.

Ниже приводятся все категории информации(для ключа типа - Аккаунт), к которой может быть предоставлен вами доступ:

Аккаунт и маркет(Account and Market)

  • Операции с кошельком
  • Операции с кошельком журнал
  • Рыночные ордера
  • Баланс счета

Связь(Communications)

  • Каналы чата
  • Тексты уведомлений
  • Уведомления
  • Почтовые сообщения
  • Списки рассылки
  • Почта
  • Контактная уведомления
  • Список контактов

Публичная информация(Public Information)

  • Информация о персонаже
  • Итоговая таблица
  • Награды
  • Лог убийств
  • Статистика войн

Наука и производство(Science and Industry)

  • Исследования
  • Промышленная дейтельность

Личная информация(Private Information)

  • Закладки
  • Координаты
  • Контракты
  • Состояние счета
  • Информация о персонаже
  • Календарь предстоящих событий
  • Очередь изучающихся навыков.
  • Навыки изученные
  • Лист персонажа
  • Календарь событий
  • Список активов

Аналогично и для ключа типа - Корпорация.

Далее нажимаете submit и ключ будет создан. Далее он готов к использованию


Где используется

Зачастую данная возможность реализованна для Корпораций(клан сайты) и доп. приложении для мира EVE. Что упрощает момент обмена информацией с со партийцами.

Управление

Создать свой API ключ вы можете перейдя по данной ссылке: ключа

Для разработчиков

EVE API представляет из себя веб-сервер; вызывая функцию API, вы, по сути, открываете веб-страницу, передавая ей (если требуется) параметры с помощью методов GET или POST, получая в ответ XML-файл с данными. Самые распространённые параметры, требуемые для вызова API-функции — keyID и vCode.

Кэширование

Для снижения нагрузки на сервер данные кэшируются с определенной периодичностью. Все XML-файлы, возвращаемые сервером при вызове API-функции, содержат такие параметры как currentTime и cachedUntil. Параметр currentTime показывает текущее время API-сервера, а cachedUntil информирует о времени, когда данные устареют и можно будет повторно вызвать данную функцию. В зависимости от типа кэширования, параметр cachedUntil можно понимать немного по-разному.

Всего используется три вида кэширования:

  1. long - как правило используется ключами не требующими постоянного обновления. К примеру информация по затратам из кошелька, раночная информация и т.д.
  2. short - используется в случае если данные требуют частого обновления, указывая приэтом время их обновления.
  3. m-short - подобен short, но не указывает время изменения данных. Используется в случаях когда можно сложный запрос разбить на части и выдавать информацию постепенно.

Ошибки

Существует определенный список ошибок:

  • 1xx — ошибки в пользовательском вводе
  • 2xx — ошибки аутентификации
  • 5xx — ошибки на стороне сервера
  • 9xx — прочие ошибки

Если же появляется ошибка начинающаяся с "0" - это указывает что вами используются слишком большие числа.

API - функции

API функции
/api/CallList.xml.aspx

Список масок и групп для API-ключа

/account/Characters.xml.aspx

Список персонажей, для которых действителен данный ключ

/account/AccountStatus.xml.aspx

Основная информация об аккаунте

/account/APIKeyInfo.xml.aspx

Информация об API-ключе.

/char/AccountBalance.xml.aspx

Баланс кошелька персонажа

/char/AssetList.xml.aspx

Список имущества персонажа

/char/CalendarEventAttendees.xml.aspx

Участники конкретного события в календаре

/char/CharacterSheet.xml.aspx

Листок персонажа

/char/ContactList.xml.aspx

Контакт-лист персонажа

/char/ContactNotifications.xml.aspx

Уведомления о добавлении в чей-то контакт-лист

/char/ContractBids.xml.aspx

Ставки на Auction-контракты.

/char/ContractItems.xml.aspx

Товары в контрактах

/char/Contracts.xml.aspx

Список контрактов заданного персонажа

/char/FacWarStats.xml.aspx

Участие во фракционных войнах

/char/IndustryJobs.xml.aspx

Список производственных заданий

/char/Killlog.xml.aspx

Список убийств

/char/MailBodies.xml.aspx

"Содержание" почтовых сообщений

/char/MailingLists.xml.aspx

Рассылка, на которую подписан пилот

/char/MailMessages.xml.aspx

Заголовки почтовых сообщений

/char/MarketOrders.xml.aspx

Ордера в маркете

/char/Medals.xml.aspx

Награды

/char/Notifications.xml.aspx

Почтовые уведомления

/char/NotificationTexts.xml.aspx

"Содержание" почтовых уведомлений

/char/Research.xml.aspx

Активные R&D-исследования

/char/SkillInTraining.xml.aspx

Текущие изучаемые навыки

/char/SkillQueue.xml.aspx

Очередь навыков

/char/Standings.xml.aspx

Стендинги к NPC

/char/UpcomingCalendarEvents.xml.aspx

Грядущие события в календаре

/char/WalletJournal.xml.aspx

История операций с кошельком

/char/WalletTransactions.xml.aspx

История транзакций в маркете

КОРПОРАЦИЯ
/corp/AccountBalance.xml.aspx

Количество ISK в кошельках корпорации

/corp/AssetList.xml.aspx

Имущество корпорации

/corp/ContactList.xml.aspx

Контакт-лист корпорации и альянса

/corp/ContainerLog.xml.aspx

История операций с корпоративными контейнерами

/corp/ContractBids.xml.aspx

Ставки на Auction-контракты

/corp/ContractItems.xml.aspx

Товары в контрактах

/corp/Contracts.xml.aspx

Корпоративные контракты

/corp/CorporationSheet.xml.aspx

Листок информации о корпорации

/corp/FacWarStats.xml.aspx

Участие корпорации во фракционных войнах

/corp/IndustryJobs.xml.aspx

Список корпоративных производственных заданий

/corp/Killlog.xml.aspx

Список киллмыл членов корпорации

/corp/MarketOrders.xml.aspx

Корпоративные ордера в маркете

/corp/Medals.xml.aspx

Выпущенные корпорацией медали

/corp/MemberMedals.xml.aspx

Медали членов корпорации

/corp/MemberSecurity.xml.aspx

Список назначенных ролей

/corp/MemberSecurityLog.xml.aspx

Изменения корпоративных ролей

/corp/MemberTracking.xml.aspx

Местоположение членов корпорации

/corp/OutpostList.xml.aspx

Список станций, принадлежащих корпорации

/corp/OutpostServiceDetail.xml.aspx

Список сервисов на станциях корпорации

/corp/Shareholders.xml.aspx

Владельцы акций корпорации

/corp/Standings.xml.aspx

Корпоративные стендинги к NPC

/corp/StarbaseDetail.xml.aspx

Текущее состояние ПОСа

/corp/StarbaseList.xml.aspx

Список ПОСов

/corp/Titles.xml.aspx

Должности

/corp/WalletJournal.xml.aspx

История операций с кошельками корпорации

/corp/WalletTransactions.xml.aspx

История транзакций корпорации в маркете

ДРУГИЕ
/eve/AllianceList.xml.aspx

Список альянсов в игре

/eve/CertificateTree.xml.aspx

Список сертификатов в игре

/eve/CharacterID.xml.aspx

Конвертация имени сущности в идентификатор

/eve/CharacterInfo.xml.aspx

Информация о конкретном персонаже

/eve/CharacterName.xml.aspx

Конвертация идентификатора сущности в имя

/eve/ConquerableStationList.xml.aspx

Список станций, включая не-NPC-станции

/eve/ErrorList.xml.aspx

Список ошибок API-сервера

/eve/FacWarStats.xml.aspx

Информация о фракционных войнах

/eve/FacWarTopStats.xml.aspx

TOP-100 во фракционных войнах

/eve/RefTypes.xml.aspx

Типы операций кошелька

/eve/SkillTree.xml.aspx

Список всех навыков

/eve/typeName.xml.aspx

Название предмета или предметов, идентификаторы которых (IDs) указаны в запросе.

КАРТА
/map/FacWarSystems.xml.aspx

Оспариваемые во фракционных войнах системы

/map/Jumps.xml.aspx

Статистика посещений систем

/map/Kills.xml.aspx

Статистика убийств по системам

/map/Sovereignty.xml.aspx

Статистика суверенитета

/map/SovereigntyStatus.xml.aspx

Список суверенитетообразующего оборудования (функция отключена)

СЕРВЕР
/server/ServerStatus.xml.aspx

Статус сервера

Обнаружено использование расширения AdBlock.


Викия — это свободный ресурс, который существует и развивается за счёт рекламы. Для блокирующих рекламу пользователей мы предоставляем модифицированную версию сайта.

Викия не будет доступна для последующих модификаций. Если вы желаете продолжать работать со страницей, то, пожалуйста, отключите расширение для блокировки рекламы.

Также на ФЭНДОМЕ

Случайная вики