5 ответов в теме

[Takeshi Ryuu]

Оригинал дев-блога.

Перевод опять частичный, убрана сср-шная вода по поводу того, что CCP PrismX ушел с работы над API, а CCP Elerhino вернулся.

Первый взгляд
По адресу https://supporttest.eveonline.com/API можно начать создавать настраиваемые API ключи для использования на API сервере для сингулярити (http://apitest.eveonline.com/).

После создания настраиваемого ключа можно опрашивать API, подставляя в нужных местах keyID, vCode и, при необходимости, characterID.

Например,

https://apitest.eveonline.com/char/CharacterSheet.xml.aspx?keyID=1&vCode=SOSECRETYOUCANTKNOW&characterID=42

(не работает, могли бы и работающий пример подсунуть).

Создание ключей с требуемым уровнем доступа
Программы, для работы которых требуются API ключи с определёнными характеристиками, могут направить пользователя на страницу для создания ключа, адрес которой создаётся по следующему шаблону:

http://supporttest.eveonline.com/api/Key/CreatePredefined/{accessMask}/{characterID}/{isCorporationKey(true/false)}

Параметры characterID и isCorporationKey являются опциональными при создании ключей персонажей, и требуются для создания корпоративных ключей, причем соответствующий персонаж должен быть CEO (не директор, не простой персонаж с нужными ролями, а только цео?). Примеры:
Страница для создания ключа персонажа с маской доступа:

http://supporttest.eveonline.com/api/Key/CreatePredefined/9830414

Страница для создания ключа персонажа с маской и идентификатором персонажа:

http://supporttest.eveonline.com/api/Key/CreatePredefined/9830414/150145436

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

http://supporttest.eveonline.com/api/Key/CreatePredefined/9830414/150145436/false

Страница для создания корпоративного ключа:

http://supporttest.eveonline.com/api/Key/CreatePredefined/9830414/150145448/true

Проверка уровня доступа ключа
API метод account/APIKeyInfo.xml.aspx позволяет проверить уровень доступа ключа.

Запрос вида

http://apitest.eveonline.com/account/APIKeyInfo.xml.aspx?keyID=42&vCode=VERYSECRET

вернёт ответ вида

Поле accessMask является битовой маской, описание всех масок можно получить по адресу http://apitest.eveon...lllist.xml.aspx

Обратная связь
ССР запускают ранний доступ к этой функциональности на тестов сервере и хотят как можно больше различных отзывов, чтобы при необходимости доделать/переделать то, что потребуется. Шлите баги или отвечайте в теме на офф-форуме.


Битовые маски
Судя по http://apitest.eveon...lllist.xml.aspx, присутствует как высокоуровневая группировка вызовов, так и более низкоуровневая.

Высокоуровневая (идентификатор группы - название - описание):
1 - кошелек и рынок (Account and Market) - ордера, транзакции и состояние кошельков.
2 - наука и производство (Science and Industry) - датакоры (ресеч поинты?) и производственные и научные работы/
3 - частная информация (Private Information) - персональная информация о владельце, ассеты, скилы и очереди скилов, календари, и так далее.
4 - публичная информация (Public Information) - медали, килмыла (сливы от нпц публичная информация? =) ), нпц стенды, фракцвар статистика.
5 - члены корпорации (Corporation Members) - информация по членам корпорации.
6 - аутпосты и посы (Outposts and Starbases) - информация по аутпостам и посам корпорации.
7 - общение (Communications) - частная информация наподобие контакт-листа, почты и уведомлений.

Низкоуровневая для персонажа (маска - группа - название - описание):
1 - 1 - баланс кошелька (AccountBalance) - текущий баланс кошелька
2 - 3 - ассеты (AssetList) - полный список всех ассетов персонажа.
4 - 3 - (CalendarEventAttendees) - список персонажей, ответивших на событие в календаре.
8 - 3 - лист персонажа (CharacterSheet) - информация о персонаже наподобие show info.
16 - 7 - контакты (ContactList) - список контактов со стендами.
32 - 7 - уведомления по контактам (ContactNotifications) - недавние уведомления по поводу контактов (персонаж такой-то добавил вас в свой контакт лист?).
64 - 4 - фракц-войны (FacWarStats) - статистика достижений персонажа в фракционных войнах.
128 - 2 - производственные задания (IndustryJobs) - список текущих и завершенных производственных заданий персонажа.
256 - 4 - кил-лог (KillLog) - килмыла персонажа.
512 - 7 - тексты писем (MailBodies) - полные тексты писем.
1024 - 7 - списки рассылки (MalingLists) - список списков рассылки, на которые подписан персонаж.
2048 - 7 - список писем (MailMessages) - список писем.
4096 - 1 - ордера (MarketOrders) - список ордеров.
8192 - 4 - медали (Medals) - список медалей, которым награждён персонаж.
16384 - 7 - уведомления (Notifications) - список недавних уведомлений.
32768 - 7 - тексты уведомлений (NotificationTexts) - полные тексты уведомлений.
65536 - 2 - ресеч-агенты (Research) - список всех ресеч-агентов, работающих с персонажем.
131072 - 3 - изучаемый навык (SkillInTraining) - навык, изучаемый персонажем в данный момент.
262144 - 3 - очередь навыков (SkillQueue) - полная очередь навыков.
524288 - 4 - нпц стенды (Standings) - стенды нпц корпораций/фракций к персонажу.
1048576 - 3 - события в календаре (UpcomingCalendarEvents) - приближающиеся события в календаре.
2097152 - 1 - журнал кошелька (WalletJournal) - журнал кошелька персонажа.
4194304 - 1 - транзакции кошелька (WalletTransactions) - рыночные транзакции по кошельку персонажа.
8388608 - 3 - информация о персонаже (CharacterInfo) - информация о персонаже, включая скилпоинты и текущий корабль в дополнение к тому, что показывается по show info.
16777216 - 4 - частная информация о персонаже (CharacterInfo) - плюс баланс кошелька и последнее местоположение персонажа в дополнение к информации из предыдущего вызова.

Низкоуровневая для корпорации (маска - группа - название - описание):
1 - 1 - баланс кошельков (AccountBalance) - баланс всех корп-кошельков.
2 - 3 - ассеты (AssetList) - список всех корп-ассетов.
4 - 5 - выданные медали (MemberMedals) - список медалей/награждений членов корпорации.
8 - 3 - лист корпорации (CorporationSheet) - то же, что show info, плюс лимит численности и базовая (?) информация по дивизионам и кошелькам.
16 - 7 - контакты (ContactList) - корп-контакты.
32 - 3 - лог доступа к контейнерам (ContainerLog) - лог доступа к секур-контейнерам.
64 - 4 - фракц-войны (FacWarStats) - статистика достижений корпорации в фракционных войнах.
128 - 2 - производственные задания (IndustryJobs) - список текущих и завершенных производственных заданий корпорации.
256 - 4 - кил-лог (KillLog) - килмыла корпорации.
512 - 5 - роли/титулы членов (MemberSecurity) - роли/титуты членов корпорации.
1024 - 5 - лог ролей/титулов (MemberSecurityLog) - лог изменений ролей/титулов членов корпорации.
2048 - 5 - члены корпы (MemberTracking) - список членов корпорации с указанием времени последнего логофа, корабля и местоположения.
4096 - 1 - ордера (MarketOrders) - корп-ордера.
8192 - 4 - медали (Medals) - список медалей, созданных корпорацией.
16384 - 6 - аутпосты (OutpostList) - список аутпостов, контролируемых корпорацией.
32768 - 6 - настройки аутпостов (OutpostServiceDetail) - список всех настроек на аутпостах корпорации.
65536 - 1 - акционеры (Shareholders) - список акционеров корпорации.
131072 - 6 - настройки посов (StarbaseDetail) - список всех настроек на посах корпорации.
262144 - 4 - нпц стенды (Standings) - стенды нпц корпораций/фракций к корпорации.
524288 - 6 - посы (StarbaseList) - список посов корпорации.
1048576 - 1 - журнал кошелька (WalletJournal) - журналы кошельков корпорации.2097152 - 1 - транзакции кошелька (WalletTransactions) - рыночные транзакции по кошелькам корпорации.
4194304 - 5 - титулы (Titles) - титулы, настроенные в корпорации, и присвоенные им роли.

Сообщение отредактировал Takeshi Ryuu: 26 May 2011 - 22:12

[konf]

Теперь можно будет сделать смс уведомление, что кто-то влез в корпоративный контейнер ? Или что пос атакован ?

[Takeshi Ryuu]

Это всё можно и сейчас, просто ключ доступа один на всё. Про новые API вызовы речи пока нет, хотя в Q&A топике сср говорило, что как минимум апи для получения информации о контрактах и них на самом-самом верху приоритетов. Может к тому времени, как настраиваемые ключи доедут до транквилити, заодно и какие-то новые апи методы появятся.

[LAZst]

на Verification Code могли бы и кнопку прикрутить "Generate"

Сообщение отредактировал LAZst: 27 May 2011 - 14:12

[Takeshi Ryuu]

Как?

Так же, как и раньше - сесть и написать такой сервис.

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