Jump to content

Донат
На хостинг
ISK за переводы
до 75kk за 1000зн.
Хроники EVE
Сборник
Новичкам
Полезная информация
Photo

API ключи с настраиваемым уровнем доступа выложены на тест-сервер


  • Please log in to reply
5 replies to this topic

#1
Takeshi Ryuu

Takeshi Ryuu

    Clone Grade Eta

  • Tech III Pilots
  • PipPipPipPip
  • 696 posts
361
  • EVE Ingame:Takeshi Ryuu
  • Corp:IRR
  • Client:Eng
Оригинал дев-блога.

Перевод опять частичный, убрана сср-шная вода по поводу того, что 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) - титулы, настроенные в корпорации, и присвоенные им роли.

Edited by Takeshi Ryuu, 26 May 2011 - 22:12.

  • 6

#2
konf

konf

    Clone Grade Epsilon

  • Tech III Pilots
  • PipPipPip
  • 275 posts
67
  • EVE Ingame:Nirka
  • Corp:XB
  • Ally:SE
  • Client:Eng
Теперь можно будет сделать смс уведомление, что кто-то влез в корпоративный контейнер ? Или что пос атакован ?
  • 0
Спойлер

#3
Takeshi Ryuu

Takeshi Ryuu

    Clone Grade Eta

  • Tech III Pilots
  • PipPipPipPip
  • 696 posts
361
  • EVE Ingame:Takeshi Ryuu
  • Corp:IRR
  • Client:Eng
Это всё можно и сейчас, просто ключ доступа один на всё. Про новые API вызовы речи пока нет, хотя в Q&A топике сср говорило, что как минимум апи для получения информации о контрактах и них на самом-самом верху приоритетов. Может к тому времени, как настраиваемые ключи доедут до транквилити, заодно и какие-то новые апи методы появятся.
  • 0

#4
LAZst

LAZst

    Clone Grade Beta

  • Tech III Pilots
  • Pip
  • 61 posts
4
  • Client:Eng
на Verification Code могли бы и кнопку прикрутить "Generate"

Edited by LAZst, 27 May 2011 - 14:12.

  • 0

#5
Keina Aarn*Нейтрал

Keina Aarn*Нейтрал
  • Guests

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


Как?
  • 0

#6
Takeshi Ryuu

Takeshi Ryuu

    Clone Grade Eta

  • Tech III Pilots
  • PipPipPipPip
  • 696 posts
361
  • EVE Ingame:Takeshi Ryuu
  • Corp:IRR
  • Client:Eng

Как?

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

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




0 user(s) are reading this topic

0 members, 0 guests, 0 anonymous users