사용자 도구

사이트 도구

    - Players

api
ESI에서 넘어왔습니다.

API

기존 API가 패치로 폐지되고 ESI(EVE Swagger Interface) 로 대체되었다.

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

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

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

1. API 관리

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

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

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

2. API Scope

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
api.txt · 마지막으로 수정됨: 2019/02/16 19:26 저자 samktg




Copyright ⓒ 2013-2019 Funzinnu All rights reserved. / Documentations under CC Attribution-Noncommercial-Share Alike 4.0 International / Open sources are copyright of their respective owners. EVE Online and the EVE logo are the registered trademarks of CCP hf. All rights are reserved worldwide. All other trademarks are the property of their respective owners. EVE Online, the EVE logo, EVE and all associated logos and designs are the intellectual property of CCP hf. All artwork, screenshots, characters, vehicles, storylines, world facts or other recognizable features of the intellectual property relating to these trademarks are likewise the intellectual property of CCP hf. CCP hf. has granted permission to Funzinnu to use EVE Online and all associated logos and designs for promotional and information purposes on its website but does not endorse, and is not in any way affiliated with, Funzinnu. CCP is in no way responsible for the content on or functioning of this website, nor can it be liable for any damage arising from the use of this website.