Ещё один девблог про 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.

На этом всё. Следите за изменениями, дабы быть в курсе.

Перевод © vizvig