API EVE Online
- API-функции
- Аргументы
- Информация
- Краткое описание сервисов
- Аккаунт (2)
- Информация о персонаже (23)
- Информация о корпорации (23)
- EVE Online (11)
- Карты (4)
- Остальные сервисы (2)
API-функции:
Каждый API-адресс состоит из базовой ссылки + какого-либо параметра (запроса), который должен быть отправлен. Например, API персонажа требует userID и apiKey, полная ссылка получается вот так:
https://api.eveonline.com/account/characters.xml.aspx?userID=#####&apiKey=#########, такая структура используется для всех API-ссылок. Ниже вы найдёте все сервисы.
На данный момент насчитывается всего 65 API-сервисов.
Аргументы:
Дабы получить требуемые данные, предоставляемые API-сервисом, вам необходимо будет предоставить дополнительные аргументы, такие как идентификатор персонажа или идентификатор предмета, в зависимости от вызываемого сервиса. Эти аргументы предоставляются таким же образом, как аутентификация, через HTTP метод POST. Однако если какой-либо из аргументов не является действительным, то вам будет выдана ошибка. Аргументы требуемые каким-либо API-сервисом можно найти в описании этого сервиса (в таблице ниже).
Информация
| API EVE Online | Общая информация по предоставляемому сервису. | Методы кэширования | В данной теме представлены все методы кэширования и их описание. |
Краткое описание сервисов:
| Аккаунт | |
| API-сервис: | Кратское описание: |
| Персонажи | Выдаёт информацию о персонаже, userID и apiKey которого были введены в запросе. |
| Статус | Выдаёт основную информацию аккаунта о времени, когда подписка истекает, полное время игры в минутах, полное время и дату создания учётки\перса. В случае аккаунтов, созданных с GTC, сервис так же будет искать доступные предложения времени. |
Информация о персонаже |
|
| API-сервис: | Кратское описание: |
| Баланс аккаунта | Данный сервис предоставляет баланс аккаунта и баланс выбранного персонажа. |
| Активы | Этот сервис показывает все активы, которые имеет запрашиваемый персонаж. |
| Участники календарных событий | Этот сервис выводит всех участников, которые подтвердили о принятие у частия в тои или ином календарном событии. |
| Обзор персонажа |
Этот сервис отображает информацию персонажа по его представленному ID. Этот лист содержит такую информацию, как кнапример, имя персонажа, расу, родословную, пол, корпорацию в которой он состоит и баланс кошелька. Атрибуты и выученные персонажем навыки тоже добавлены в этот лист. |
| Контактный лист | Этот сервис выводит весь список контактов выбранного персонажа (так же выводятся агенты и выставленный стендинг (отношение)). |
| Контактные уведомления | Этот сервис выдаёт информацию об уведомлениях при нанелсении кого-либо в контактный лист. |
| Статистика фракционной войны | Этот сервис выдаёт список зачисленных во фракционную войну персонажей. Выводится имя персонажа, фракция, ранг и достижения. Так же выводится информация о кол-ве убийств и полученых очках за прошедший день и неделю запрашиваемым персонажем. |
| Производственные работы | Этот сервис показывает все производственные работы, которые активны в данное время у запрашеваемого персонажа. |
| Журнал убийств | Этот сервис выдаёт список из 25 последних убийств. |
| Список рассылок | Этот сервис выдаёт xml-документ, в котором перечислены все рассылки для запрашиваемого персонажа. |
| Заголовки писем | Этот сервис выдаёт названия всех существующих у запрашиваемого персонажа писем. |
| Текст письма | Этот сервис выдаёт текст письма (если оно есть) запрашиваемого персонажа. |
| Рыночные ордера | Этот сервис ывдаёт все рыночные ордера поставленные запрашиваемым персонажем. |
| Медали | Этот сервис показывает все медели, которые имеет запрашиваемый персонаж. |
| Notification Texts | Этот сервис показывает текст существующих у персонажа уведомлений. |
| Уведомления | Этот сервис выводит все уведомления, которые есть у запрашеваемого персонажа. |
| NPC отношения | Этот сервис выводит список отношений к персонажу тех или иных NPC корпораций, фракций или агентов. |
| Исследования | Этот сервис выводит все исследования на данный момент, проводимые определённым персонажем. |
| Навыки в обучении | Этот сервис показывает изучаемые на данный момент навыки определённым персонажем. |
| Навыки в очереди | Этот сервис выводит все навыки, которые стоят в очереди на обучение определённым персонажем если соблюдается правило 24 часов, т.е. если несколько навыков укладываются по времени изучения в 24 часа, то они будут выводиться, если нет, то и поставить вы их не сможете. |
| Собиытия в календаре | Этот сервис выводит информацию по событиям в календаре определённого персонажа. |
| Журнал кошелька | Этот сервис выводит онформацию по всем действиям с кошельком указанного персонажа. |
| Транзакции кошелька | Этот сервис выводит информацию только о рыночных транзакциях. Что именно? - Где, у кого и сколько куплено, а так же налог и т.д. |
Информация о корпорации |
|
| API-сервис: | Кратское описание: |
| Баланс | Этот сервис выводит xml файл с балансом корпорации. Проставтривать эту информацию могут: младший бухгалтер, старший бухгалтер, директор и CEO. |
| Активы | Этот сервис выводит все активы корпорации и их местоположение. Обратите внимание, что некоторые из активов могут быть в пределах других созвездий (собственно гвооря это не особо важно, т.к. информация показывается по всем активам корпорации). Вся информация в xml файле имеет свои уровни. |
| Контакты | Этот сервис выводит список всех контактов корпорации и доступно это для всех её членов. |
| Лог контейнеров | Этот сервис показывает лог аудитного контейнера корпорации. |
| Обзор корпорации | Этот сервис выводит вам на экран полные детали корпорации. API-кобчик для этого не тредуется, однако CEO или Директор корпорации могут просмотреть гораздо больше информации используя свой apiKey. Собственно говоря вы получите ту информацию, которая выводится в игре. |
| Статистика фракционной войны | Этот сервис выдаёт статистику всех членов корпорации участвующих во фракционной войне, включая ID их фракции и ранги, убийства и итог количества полученых очков за прошедший день и неделю. |
| Производственные работы | Этот сервис выдаёт полный список всех производственных работ корпорации. Обратите внимание, что для получения этого списка нужна роль Производственного менеджера или выше (CEO или Директор). |
| Журнал убийств |
Этот сервис выдаёт информацию о 100 последних убийствах. Показвается информация о то что выпало с жертвы и информацию о самой жертве. Пользователь делающий запрос на данную информацию должен иметь apiKey CEO или Директора корпорации. Заметьте, что есть дополнительный параметр для этой API-функции. Вызвается он при помощи beforeKillID, который позволяет Вам возвращать другие убийства перед указанным killID. |
| Рыночные ордера | Этот сервис выдаёт информацию по рыночным ордерам выставленным корпорацией. |
| Медали | Этот сервис выдаёт список медалей корпорации. |
| Награждённые медалями | Этот сервис выдаёт список тех, кого наградили медалями в корпорации. |
| Member Security | Этот сервис выдаёт информацию о ролях того или иного пилота корпорации. |
| Member Security Log | Этот сервис выдаёт информацию об изменениях ролей для членов корпорации и о том, кто это сделал. |
| Слежение за членами | Этот сервис позволяет вам скачать xml или CVS файл со списком пилотов корпорации. Этот список полезен для CEO и Директоров корпорации. Перед вами будет выбор что скачать, CVS или xml файл. |
| NPC Отношения | Этот сервис выдаёт информацию об отношении к корпорации NPC корпораций, фракций и агентов. |
| Outpost List | Этот сервис выдаёт список всех аутпостов которыми владеет корпорация. Для этого требуется полный apiKey CEO или Директора корпорации-владельца аутпоста. |
| Outpost Service Detail | Этот сервис выдаёт информацию об аутпостах корпорации. Для этого требуется полный apiKey CEO или Директора корпорации-владельца аутпоста. |
| POS Detail | Этот сервис выводит информацию касательно конфигурации и топлива POS'а (обозначенного в URL как itemID). |
| Список POS'ов |
Этот сервис выводит информацию о всех посах корпорации, их местонаходжении (ID системы, планеты и луны). Кстате гвооря, роль того кто запрашивает данную информацию должна быть не меньше директорской, а именно CEO или Директор корпорации. |
| Владельци акций | Этот сервис выводит полный список тех, что кладеет акциями корпорации. |
| Названия | Этот сервис выводит все названия корпорации. |
| Журнал кошелька | Этот сервис выводит на экран журнал кошелька, в котором представлены все доходы и расходы. |
| Транзакции кошелька | Этот сервис показывает данные найденые в игре. Выдаётся информация о том кто продал передмет, кол-во купленного предмета, цена и где именно куплен тот или иной предмет. |
EVE Online |
|
| API-сервис: | Кратское описание: |
| Список альянсов | Этот сервис выдаёт весь список всех альянсов в EVE Online. |
| Древо сертификатов | Этот сервис выдаёт полное древо всех сертификатор EVE Online. |
| ID персонажа | Этот сервис выдаёт ID персонажа, чтобы соответствовать указанному разграниченному запятой списку имен персонажей. |
| Информация о персонаже | Эта функция выдаёт информацию о пресонаже. API-ключ не требулется, т.к. информация показывается точно так же как и в игре. Однако этот сервис содержит 3 вида вывода информации: ознакомительный - как в игре, частичный - при использовании простого API-ключа и полный - при исмользовании полного API-ключа соответственно. |
| Имя персонажа | Этот сервис выдаёт список имен персонажей, чтобы соответствовать указанному разграниченному запятой списку удостоверений личности персонажа. |
| Список захватываемых станций | Этот сервис предоставляет список всех станций или аутпостов которые можно звахватить, так же предоставляется иннформация о текущем владельце этой станции |
| Список ошибок |
Этот сервис выдаёт полный список всех ошибок. Типы ошибок можно разделить на 4 типа. |
| Статистика фракционной войны | Этот сервис выдаёт некоторую общую статистику по фракционной войне, которая является частью неземного века EVE Online. В эти статистические данные включена информация об убийствах и присуждаемых очках победы. Далее эта информация подразделена согласно фракциям. |
| ТОР-100 во фракционных войнах | Этот сервис показывает 100 лидеров во фракционных войнах. |
| Reference Types | Этот сервис выдаёт полный список операционных типов бумажника, которые используются в записях журнала. |
| Древо навыков | Этот API-сервис показывает полное древо навыков EVE Online. Это древо состоит из групп, которые содержат ряд присущих им навыков. |
Карты |
|
| API-сервис: | Кратское описание: |
| Системы фракционных войн | Это карта фракционных войн. Содержит список систем, в которых ведутся войны, фракцию которая владеет той или иной системой (если значение применимо) и показывает, является ли система спорным сектором. Так же эти данные могут быть применены при создании карты фракционных войн вселенной EVE Online. |
| Прыжки | Этот API-сервис ппоказывает кол-во прыжков (через врата) в системе. Короче говоря, показывает посещаемость системы. |
| Убийства | Данная функция позволяет посмотреть степень убийств и подов в какой-либо системе. |
| Суверенитет | API-сервис суверенитета предоставляет обзор всех солнечных систем с суверенитетом, его уровень, название и идентификатор фракции-владельца. |
Остальные сервисы |
|
| API-сервис: | Кратское описание: |
| ID для портрета персонажа и логотипа корпорации или альянса |
Данный сервис позволяет получить портрет персонажа, логотип корпорации или альянса. Старый портретный сервер всё ещё работает, но в конечном итоге будет отключен. Для портретов прерсонажей используется формат файла *jpg, а имя файла имеет общую структуру «characterID»_«size».jpg. Для логотипов корпораций и альянсов используется формат *png. |
| Статус сервера | Данная функция делает API заапрос к xml файлу и выдаёт статус сервера: онлайн\офлайн и кол-во пилотов в игре. |
Хочу сказать, что эта таблица будет обновляться в зависимости от моего свободного времени. Т.е. появился свободный час - я добавлю несколько статей по API функциям перечисленным в данных таблицах.
Перевод © [VindDevil]
Источник: http://wiki.eveonline.com/en/wiki/EVE_API_Functions
![[VindDevil]](/VindDevil.jpg){kind=link}