문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 | ||
api [2017/06/29 11:16] 127.0.0.1 외부 편집 |
api [2019/02/16 19:26] (현재) samktg [API] |
||
---|---|---|---|
줄 1: | 줄 1: | ||
====== API ====== | ====== API ====== | ||
- | + | ||
- | 이브온라인은 캐릭터 정보 및 사용자의 데이터를 이브 온라인 외부에서 조회할 수 있는 HTTP 기반 API(Application Programming Interface)를 제공한다. 덕분에 Eve Fitting Tool, EveMon 같은 프로그램을 사용해서 이브 온라인에 직접 접속하지 않아도 편리하게 피팅을 맞춰보고 캐릭터의 현 상태(주로 트레이닝 큐)를 점검할 수 있다. | + | 기존 API가 패치로 폐지되고 [[https://esi.evetech.net|ESI]](EVE Swagger Interface) 로 대체되었다. |
+ | |||
+ | 이브온라인은 캐릭터 정보 및 사용자의 데이터를 이브 온라인 외부에서 조회할 수 있는 HTTP 기반 API(Application Programming Interface)를 제공한다. 덕분에 pyfa, EVEMon 같은 프로그램을 사용해서 이브 온라인에 직접 접속하지 않아도 편리하게 피팅을 맞춰보고 캐릭터의 현 상태(주로 트레이닝 큐)를 점검할 수 있다. | ||
이 둘 외에도 이것을 이용한 수많은 연동 홈페이지와 어플리케이션(PC, 안드로이드, iOS)이 있고 기능이 매우 다양하다. 이러한 특성 덕에 코퍼레이션에 API를 제출해야 가입이 가능한 곳도 있다.(스파이방지) | 이 둘 외에도 이것을 이용한 수많은 연동 홈페이지와 어플리케이션(PC, 안드로이드, iOS)이 있고 기능이 매우 다양하다. 이러한 특성 덕에 코퍼레이션에 API를 제출해야 가입이 가능한 곳도 있다.(스파이방지) | ||
줄 11: | 줄 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를 각각 만들어서 관리할 수 있다. | + | |
- | + | ||
- | ***CREATE NEW API**로 새로운 API를 만들 수 있다. | + | |
- | ***UPDATE**로 제공하는 정보의 종류나 유통기한을 수정할 수 있다. | + | |
- | ***DELETE**로 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 | + | https://community.eveonline.com/support/third-party-applications/ 에 들어가면 위와 같은 화면이 나온다. 위 화면은 이미 3개의 API를 만든 상태인데, 하나는 zKillboard로 킬메일을 받아가는 API, 나머지 두개는 코퍼레이션 제출,얼라이언스 제출용으로 모든 정보를 제공하는 API이다. 이런식으로 여러개의 API를 각각 관리할 수 있다. |
- | *Bookmarks : 북마크 | + | |
- | *Locations : 현재 캐릭터 위치 | + | |
- | *Contracts : 컨트랙 | + | |
- | *ContainerLog : 컨테이너 로그 | + | |
- | *CorporationSheet : 코퍼레이션 시트 | + | |
- | *AccountStatus : 계정정보(계정만료일, 최근접속일, 플레이타임 등) | + | |
- | *CharacterInfo : 캐릭터정보 | + | |
- | *UpcomingCalendarEvents : | + | |
- | *SkillQueue : 스킬 트레이닝 큐 | + | |
- | *SkillInTraining : 보유 스킬 | + | |
- | *CharacterSheet : 캐릭터시트 | + | |
- | *CalendarEventAttendees : 캘린더 일정 | + | |
- | *AssetList : 자산 | + | |
- | *Public Information | + | 하얀색 부분엔 해당 캐릭터의 포트레잇, 초록색 부분엔 캐릭터 명이 표시되며, 빨간색 부분엔 해당 API의 이름, 노락색 부분엔 해당 API의 설명이 표시된다. |
- | *CharacterInfo : 캐릭터정보 | + | |
- | *Standings : 스탠딩 | + | |
- | *Medals : 메달 | + | |
- | *KillLog : 킬로그 | + | |
- | *FacWarStats : 팩션워 스탯 | + | |
- | *Science and Industry | + | ***VIEW PERMISSIONS**로 제공하는 정보의 종류를 알 수 있다. |
- | *Research : 연구 | + | ***DELETE APPLICATION**로 API를 파기할 수 있다. |
- | *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 |