문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
api [2016/03/11 13:56] 220.67.178.61 [2. API 설정] |
api [2019/02/16 18:58] samktg [1. API 관리] 최신내용 업데이트 |
||
---|---|---|---|
줄 1: | 줄 1: | ||
+ | ====== 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 설정 ===== | ||
+ | |||
+ | 업데이트나 새로운 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 : 생산중인 품목 | ||
+ | |||