ФЭНДОМ


Описание

Для удобства многих игроков, разработчиками 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

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