Api Аккаунта

## Описание

Для удобства многих игроков, разработчиками EVE были созданы api для возможности доступа/рамещения информации об аккаунте, на других ресурсах.

Что такое ключ API? Как я могу использовать?

* Ключ API является частным кодом, который идентифицирует ваш аккаунт и позволяет сторонним программам и веб-сайтам, получать доступ к информации о ваших персонажах и корпорациях. Используя эти данные, такие утилиты могут способствовать своевременному оповещению о важных для вас событиях, начиная от взаимодействия с игровым функционалом(продажи/календарные события/планы/состояние корабли и т.д.), заканчивая взаимодействием с другими игроками.

Это безопасно? Может ли кто-ни буть получить доступ к моей учетной записи без моего ведома?

* Это безопасно, другие сайты и приложения получают доступ к информации о вашем аккаунте до тех пор пока вы даете на это согласие. Т.е. вы можете в любое время запретить данный доступ если сомневаетесь в безопасности ресурса, накотором предоставили свою информацию. Так же вы можете контролировать какая именно информация будет доступна другим пользователем, по тому ключу API что вы создали.

* Использование ключа API не дает людям доступ к вашей учетной записи. В этом заключается цель ключей API. Ключ API позволяет только просматривать данные персонажа и корпорации. Они не смогут войти в игру или разместить на форуме сведения об API.

Это единственный безопасный способ дать программам и веб-сайтам доступ к вашим данным.

Я до сих пор не доверяю.

* Если вы не уверены, что веб-сайт или программа, запрашиваемые ключ API, являются безопасными, пожалуйста, не предоставляйте ему ваш API ключ! Вы несете полную ответственность за любое использование информации, полученной с помощью функции API.

Я дал кому-то мой ключ API, и теперь я хочу, чтобы они не могли использовать его!

* Если вы считаете, что кто-то злоупотребляет вашим ключом API, вы можете удалить его из списка разрешенных к доступу, или просто изменить код верификации. Пожалуйста, обратите внимание, что все программы и веб-сайты, которые используют старый API ключ, больше не будут иметь возможность получить доступ к данным, если вы не предоставите им новый ключ с обновленной информацией.

Вы можете просмотреть API активности на вашем счету с помощью журнала.
API доступа
Если вы считаете, что кто-то злоупотребляет одним из ваших ключей API, пожалуйста, измените код верификации или удалить ключ API из приведенного выше списка.

## Как создать?

1. Для того чтобы создать ключ перейдите по ссылке:

https://community.eveonline.com/support/api-key/update

1. Вам необходимо будет авторизоваться.

Обратите внимание на адрес прежде чем авторизовываться. Только такой адрес является адресом ОФФ сайта.
1. После авторизации у вас появиться окно с данной информацией:

где:

Ниже приводятся все категории информации (*для ключа типа - Аккаунт*), к которой может быть предоставлен вами доступ:

### Аккаунт и маркет (Account and Market)

* Операции с кошельком
* Операции с кошельком журнал
* Рыночные ордера
* Баланс счета

### Связь(Communications)

* Каналы чата
* Тексты уведомлений
* Уведомления
* Почтовые сообщения
* Списки рассылки
* Почта
* Контактная уведомления
* Список контактов

### Публичная информация(Public Information)

* Информация о персонаже
* Итоговая таблица
* Награды
* Лог убийств
* Статистика войн

### Наука и производство(Science and Industry)

* Исследования
* Промышленная дейтельность

### Личная информация(Private Information)

* Закладки
* Координаты
* Контракты
* Состояние счета
* Информация о персонаже
* Календарь предстоящих событий
* Очередь изучающихся навыков.
* Навыки изученные
* Лист персонажа
* Календарь событий
* Список активов

Аналогично и для *ключа типа - Корпорация*.

Далее нажимаете submit и ключ будет создан. Далее он готов к использованию

## Где используется

Зачастую данная возможность реализованна для Корпораций(клан сайты) и доп. приложении для мира EVE. Что упрощает момент обмена информацией с со партийцами.

## Управление

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

## Для разработчиков

EVE API представляет из себя веб-сервер; вызывая функцию API, вы, по сути, открываете веб-страницу, передавая ей (если требуется) параметры с помощью методов GET или POST, получая в ответ XML-файл с данными. Самые распространённые параметры, требуемые для вызова API-функции — keyID и vCode.

### Кэширование

Для снижения нагрузки на сервер данные кэшируются с определенной периодичностью. Все XML-файлы, возвращаемые сервером при вызове API-функции, содержат такие параметры как currentTime и cachedUntil. Параметр currentTime показывает текущее время API-сервера, а cachedUntil информирует о времени, когда данные устареют и можно будет повторно вызвать данную функцию. В зависимости от типа кэширования, параметр cachedUntil можно понимать немного по-разному.

Всего используется три вида кэширования:

1. long - как правило используется ключами не требующими постоянного обновления. К примеру информация по затратам из кошелька, раночная информация и т.д.
2. short - используется в случае если данные требуют частого обновления, указывая приэтом время их обновления.
3. m-short - подобен short, но не указывает время изменения данных. Используется в случаях когда можно сложный запрос разбить на части и выдавать информацию постепенно.

### Ошибки

Существует определенный список ошибок:

* 1xx — ошибки в пользовательском вводе
* 2xx — ошибки аутентификации
* 5xx — ошибки на стороне сервера
* 9xx — прочие ошибки

Если же появляется ошибка начинающаяся с "0" - это указывает что вами используются слишком большие числа.