====== API ======

기존 API가 패치로 폐지되고 [[https://esi.evetech.net|ESI]](EVE Swagger Interface) 로 대체되었다.

이브온라인은 캐릭터 정보 및 사용자의 데이터를 이브 온라인 외부에서 조회할 수 있는 HTTP 기반 API(Application Programming Interface)를 제공한다. 덕분에 pyfa, EVEMon 같은 프로그램을 사용해서 이브 온라인에 직접 접속하지 않아도 편리하게 피팅을 맞춰보고 캐릭터의 현 상태(주로 트레이닝 큐)를 점검할 수 있다. 
이 둘 외에도 이것을 이용한 수많은 연동 홈페이지와 어플리케이션(PC, 안드로이드, iOS)이 있고 기능이 매우 다양하다. 이러한 특성 덕에 코퍼레이션에 API를 제출해야 가입이 가능한 곳도 있다.(스파이방지)

<wrap em>API는 앞서 말한 캐릭터의 각종 정보를 조회할 수 있을 뿐이며 제어는 절대 불가능하다. 따라서 계정 도용이나 해킹의 위험은 없다.</wrap>

하지만 API가 제공하는 정보는 어마어마하다는 점.\\
<wrap em>알려지면 안되는 각종 기밀 정보도 조회할 수 있으니 절대 공개된 장소에 API를 올리면 안된다!</wrap> API를 만들때 어떤 정보를 포함할 것인지 자세하게 설정할 수 있다.

===== - API 관리 =====

{{https://i.ibb.co/bRf5fvM/20190216-184635.png}}

https://community.eveonline.com/support/third-party-applications/ 에 들어가면 위와 같은 화면이 나온다. 위 화면은 이미 3개의 API를 만든 상태인데, 하나는 zKillboard로 킬메일을 받아가는 API, 나머지 두개는 코퍼레이션 제출,얼라이언스 제출용으로 모든 정보를 제공하는 API이다. 이런식으로 여러개의 API를 각각 관리할 수 있다.

하얀색 부분엔 해당 캐릭터의 포트레잇, 초록색 부분엔 캐릭터 명이 표시되며, 빨간색 부분엔 해당 API의 이름, 노락색 부분엔 해당 API의 설명이 표시된다.

  ***VIEW PERMISSIONS**로 제공하는 정보의 종류를 알 수 있다.
  ***DELETE APPLICATION**로 API를 파기할 수 있다.

===== - API Scope =====
{{https://i.ibb.co/VtWktC2/20190216-190013.png}}
VIEW PERMISSION 버튼을 누르면 위 사진과 같이 해당 API가 접근 가능한 정보의 범위를 볼 수 있다.

Scope마다 제공하는 정보는 다음과 같다.
  *publicData : 캐릭터 이름, 소속 얼라이언스와 코퍼레이션 같은 모든 사람이 접근 가능한 정보.
  *read_calendar_events
  *read_location : 캐릭터의 위치
  *read_ship_type : 캐릭터가 타고 있는 함선
  *read_mail : 캐릭터 메일
  *read_skills : 캐릭터 스킬
  *read_skillqueue : 캐릭터 스킬큐
  *read_character_wallet : 캐릭터 월렛
  *search_structures
  *read_clones : 캐릭터 점프클론 위치 등
  *read_contacts :
  *read_structures : 캐릭터 소속 꼽 스트럭쳐 ( 해당 캐릭터가 디렉터, CEO 권한이 있어야 꼽 소속 스트럭쳐 목록이 받아와진다. )
  *read_character_bookmarks : 캐릭터 북마크
  *read_killmails : 캐릭터 킬메일
  *read_corporation_membership
  *read_assets : 캐릭터 에셋
  *manage_planets
  *read_fleet
  *open_window : 인게임에서 정보창을 열수 있게 허용
  *read_fittings : 캐릭터에게 저장된 피팅
  *structure_markets
  *read_structures 
  *read_loyalty
  *read_opportunities
  *read_chat_channels : 캐릭터가 들어가 있는 채팅 채널
  *read_medals : 캐릭터 소유 메달
  *read_standings : 캐릭터 스탠딩 ( NPC꼽 / 팩션 )
  *read_agents_research
  *read_character_jobs
  *read_character_orders
  *read_blueprints
  *read_corporation_roles
  *read_online : 캐릭터 상태 ( 이브에 접속중인지 아닌지 )
  *read_character_contracts : 캐릭터 컨트랙
  *read_implants : 캐릭터 임플란트
  *read_fatigue : 캐릭터 점프 피로도
  *read_corporation_killmails : 꼽 킬메일 정보 ( 캐릭터가 꼽 CEO, 디렉터 권한이 있어야 적용 )
  *track_members
  *read_corporation_wallets : 꼽 월렛 정보 ( 캐릭터가 꼽 CEO, 디렉터 권한이 있어야 적용 )
  *read_notifications : 캐릭터 알림
  *read_divisions
  *read_contacts
  *read_corporation_assets : 꼽 에셋 정보 ( 캐릭터가 꼽 CEO, 디렉터 권한이 있어야 적용 )
  *read_titles : 캐릭터 타이틀
  *read_blueprints
  *read_corporation_bookmarks : 꼽 북마크
  *read_corporation_contracts : 꼽 컨트랙
  *read_standings
  *read_starbases : 꼽 소유 컨트롤 타워 정보 ( 캐릭터가 꼽 CEO, 디렉터 권한이 있어야 적용 )
  *read_corporation_jobs
  *read_corporation_orders
  *read_container_logs
  *read_character_mining : 캐릭터 마이닝 렛저
  *read_corporation_mining : 꼽 마이닝 렛저 ( 캐릭터가 꼽 CEO, 디렉터 권한이 있어야 적용 )
  *read_customs_offices : 꼽 소유 커스텀 오피스 정보 ( 캐릭터가 꼽 CEO, 디렉터 권한이 있어야 적용 )
  *read_facilities
  *read_medals
  *read_titles
  *read_contacts
  *read_fw_stats
  *read_fw_stats
  *read