사용자 도구

사이트 도구

    - Players

api

차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

양쪽 이전 판 이전 판
다음 판
이전 판
api [2018/09/11 12:11]
117.17.34.173 [API]
api [2019/02/16 19:26] (현재)
samktg [API]
줄 1: 줄 1:
 ====== API ====== ====== API ======
  
-기존 API가 패치로 폐지되고 ​ESI(https://​esi.evetech.net/)로 대체되었으므로 아래의 내용 대부분이 수정되야할 필요가 있다.+기존 API가 패치로 폐지되고 ​[[https://​esi.evetech.net|ESI]](EVE Swagger Interface) 로 대체되었다.
  
-이브온라인은 캐릭터 정보 및 사용자의 데이터를 이브 온라인 외부에서 조회할 수 있는 HTTP 기반 API(Application Programming Interface)를 제공한다. 덕분에 ​Eve Fitting ToolEveMon ​같은 프로그램을 사용해서 이브 온라인에 직접 접속하지 않아도 편리하게 피팅을 맞춰보고 캐릭터의 현 상태(주로 트레이닝 큐)를 점검할 수 있다. ​+이브온라인은 캐릭터 정보 및 사용자의 데이터를 이브 온라인 외부에서 조회할 수 있는 HTTP 기반 API(Application Programming Interface)를 제공한다. 덕분에 ​pyfaEVEMon ​같은 프로그램을 사용해서 이브 온라인에 직접 접속하지 않아도 편리하게 피팅을 맞춰보고 캐릭터의 현 상태(주로 트레이닝 큐)를 점검할 수 있다. ​
 이 둘 외에도 이것을 이용한 수많은 연동 홈페이지와 어플리케이션(PC,​ 안드로이드,​ iOS)이 있고 기능이 매우 다양하다. 이러한 특성 덕에 코퍼레이션에 API를 제출해야 가입이 가능한 곳도 있다.(스파이방지) 이 둘 외에도 이것을 이용한 수많은 연동 홈페이지와 어플리케이션(PC,​ 안드로이드,​ iOS)이 있고 기능이 매우 다양하다. 이러한 특성 덕에 코퍼레이션에 API를 제출해야 가입이 가능한 곳도 있다.(스파이방지)
  
줄 13: 줄 13:
 ===== - API 관리 ===== ===== - API 관리 =====
  
-{{https://imgone.xyz/p/145517280204efd25.jpg}}+{{https://i.ibb.co/bRf5fvM/20190216-184635.png}}
  
-https://​community.eveonline.com/​support/​api-key/ 에 들어가면 위와 같은 화면이 나온다. 위 화면은 이미 ​개의 API를 만든 상태인데,​ 하나는 ​개인용으로 모든 정보를 제공하는 API, 또 하나는 코퍼레이션 제출용으로 ​코퍼레이션에서 요구하는 ​정보만 제공하는 API다. 이런식으로 여러개의 API를 각각 ​만들어서 ​관리할 수 있다.+https://​community.eveonline.com/​support/​third-party-applications/ 에 들어가면 위와 같은 화면이 나온다. 위 화면은 이미 ​3개의 API를 만든 상태인데,​ 하나는 ​zKillboard로 킬메일을 받아가는 API, 나머지 두개는 코퍼레이션 ​제출,​얼라이언스 ​제출용으로 ​모든 ​정보를 제공하는 API다. 이런식으로 여러개의 API를 각각 관리할 수 있다.
  
-  ***CREATE NEW API**로 새로운 API를 만들 수 있다. +얀색 부분엔 해당 캐릭터의 포트레잇,​ 초록색 부분엔 캐릭터 명이 표시되며,​ 빨간색 부분엔 해당 ​API의 이름, 노락색 부분엔 해당 API의 설명이 표시된다.
-  ***UPDATE**로 제공는 정보의 종류나 유통기한을 수정할 수 있다. +
-  ***DELETE**로 ​API를 파기할 수 있다. +
  
-===== - API 설정 ===== +  ​***VIEW PERMISSIONS**로 제공하는 정보의 종류를 알 수 있다. 
- +  ***DELETE APPLICATION**로 API를 ​파기할 수 있다.
-업데이트나 새로운 API를 만드는 창에서 설정할 수 있는 정보는 다음과 같다. 당연히 이 페이지에서 설정하는 정보는 절대 아무에게도 알려주면 안된다. 특히 Verification Code와 Access Mask가 API에 접근하는 코드이므로 철저하게 관리할 것. +
- +
-  ​***Name** : 관리용 이름이다. 관리 페이지에서 보이는 이름이다. +
-  ***Character**:​ 계에 있는 모든 캐릭터를 포함할 건지, 특정 캐릭터를 정할건지 선택할 ​수 있다. +
-  ***Type**: 캐릭터 API와 콥 API를 ​선택할 수 있다. ​선택할 수 있는 정보가 달라진다. +
-  ***Verification Code**: 생성되는 인증 코드. +
-  ***Access Mask**: 생성되는 엑세스 마스크. +
-  ***Expires**:​ 파기일. No Expiry에 체크하면 자동 파기가 되지 않는다. +
- +
-제공하는 정보는 다음과 같으며 하나하나 개별 선택이 가능하다. 셀 배경이 노란색으로 되야 선택된 것이다. +
- +
-  *Account and Market +
-     ​*WalletTransactions +
-     ​*WalletJournal +
-     ​*Shareholders +
-     ​*MarketOrders +
-     ​*AccountBalance +
- +
-  *Communications +
-     ​*ChatChannels +
-     ​*NotificationTexts +
-     ​*Notifications +
-     ​*MailMessages +
-     ​*MailingLists +
-     ​*MailBodies +
-     ​*ContactNotifications +
-     ​*ContactList +
- +
-  *Corporation Members +
-     ​*MemberTrackingExtended +
-     ​*Titles +
-     ​*MemberTrackingLimited +
-     ​*MemberSecurityLog +
-     ​*MemberSecurity +
-     ​*MemberMedals +
- +
-  *Outposts and Starbases +
-     ​*StarbaseList : 스타베이스 리스트 +
-     ​*StarbaseDetail : 스타베이스 세부정보 +
-     ​*OutpostServiceDetail : 아웃포스트 서비스 세부정보 +
-     ​*OutpostList : 아웃포스트 리스트 +
- +
-  *Private Information +
-     ​*Bookmarks : 북마크 +
-     ​*Locations : 현재 캐릭터 위치 +
-     ​*Contracts : 컨트랙 +
-     ​*ContainerLog : 컨테이너 로그 +
-     ​*CorporationSheet : 코퍼레이션 시트 +
-     ​*AccountStatus : 계정정보(계정만료일,​ 최근접속일,​ 플레이타임 등) +
-     ​*CharacterInfo : 캐릭터정보 +
-     ​*UpcomingCalendarEvents :  +
-     ​*SkillQueue : 스킬 트레이닝 큐 +
-     ​*SkillInTraining : 보유 스킬 +
-     ​*CharacterSheet : 캐릭터시트 +
-     ​*CalendarEventAttendees : 캘린더 일정 +
-     ​*AssetList : 자산 +
- +
-  *Public Information +
-     ​*CharacterInfo : 캐릭터정보 +
-     ​*Standings : 스탠딩 +
-     ​*Medals : 메달 +
-     ​*KillLog : 킬로그 +
-     ​*FacWarStats : 팩션워 스탯 +
- +
-  *Science and Industry +
-     ​*Research : 연구 +
-     ​*IndustryJobs : 생산중인 품목+
  
 +===== - 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
api.1536635483.txt.gz · 마지막으로 수정됨: 2018/09/11 12:11 저자 117.17.34.173




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.