Ещё один девблог про API за несколько недель.
И это уже начинает выбиваться из рук. Я мог бы прекратить их писать, если бы они появлялись такими темпами.
Но тем не менее сейчас нам нужно поговорить про изменения в EVE API которые придут с выходом обновления криус в июле.
Сейчас у нас есть 2 конечных точки данных/выводных точки из каждой из них вы можете получать данные о производственных работах corp/IndustryJobs и char/IndustryJobs. Информация относящаяся к работам значительно изменится в обновлении криус и что-то нужно сделать с точками вывода.
Имеющееся EVE API не поддерживает управление версиями. Поэтому у нас есть 2 задумки:
1) Оставить текущие точки вывода на месте и просто перестать выдавать по ним данные. Это должно работать так как будто у вас не установлено работ. Шаблоны для данных будут оставлены, но строк с данными в них не будет.
Мы добавим новые точки вывода среди строк char/newIndustryJobs (или как я предпочту char/stEVEJobs)
За: это не сломает текущие приложения использующие API
Против: Если вы новый разработчик приложений под API вас могут запутать старые точки вывода. Вы получите из них 0 вместо ожидаемых данных.
2) Преобразовать точки выхода и дать сторонним разработчикам времени столько, сколько возможно чтобы они обновили свои приложения. Это потребует от нас установить данные точки вывода на тест сервер singularity (Sisi) как можно скорее.
За: имеет смысл для новых разработчиков
Против: Риск сломать старые приложения не способные к правильной обработке ошибок.
Это трудный выбор, но мы посоветовались с CSM, разработчиками EVE, и прочими нашими сотрудниками. И немного подумав над этим выбрали вариант 2. Мы заменим текущие выходные точки новыми данными и надеемся что это не возмутит много людей. Поэтому грядущие изменения API уже сейчас на сервере Sisi.
Добавлено - corp/Facilities:
Список всех корпоративных фабрик включая ПОСы (звёздные базы) и станции.
Чтобы видеть точку вывода выше вам нужен корпоративный api-key и персонаж с ролью директора/цео [главы]
эти данные перезаписываются раз в час.
Обновлено - char/IndustryJobs а также corp/IndustryJobs:
Соответствует новым данным собранным о работах в EVE
Чтобы видеть корпоративные работы вы должны быть ЦЕО/директором/ или иметь роль директора предприятия (директор предприятия/factory manager)
Эта точка выводит данные о всех идущих работах и перезаписывается раз в час.
Добавленно char/IndustryJobsHistory и corp/IndustryJobsHistory:
Будет выводить тот же вид данных что и industryJobs, Но будет включать как идущие так и завершенные работы.
Будет перезаписываться раз в сутки и как и сейчас включать до 1000 строк.
Мы работаем над лучшим методом управления строками, так что ожидайте здесь изменений
Такие же требования для корпоративных работ как и точки вывода IndustryJobs
Описанное выше уже на singularity так что вы можете проверить и обновить ваши приложения. Мы будем читать ваши отзывы здесь (офф). У нас есть куча времени на то, чтобы изменить то, что мы сделаем, если мы посчитаем это правильным.
Дополнительный раунд!
И в дополнение CCP Tuxford добавил две новые точки вывода для CREST-API на singularity для относящихся к производству действий.
Найти их вы можете тут: public-crest-sisi.testeveonline.com/industry/
Отмазка:
Всё описанное выше на Sisi и продолжает активно разрабатываться. В то время как мы пытаемся держать вас в курсе любых изменений, всё может измениться когда они выйдут на tranquility.
На этом всё. Следите за изменениями дабы быть в курсе.
Оригинал
18.06.2014 14:38 CCP FoxFour
Сообщение отредактировал vizvig: 24 June 2014 - 14:16