문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 마지막 판 양쪽 다음 판 | ||
api [2016/03/11 13:56] 220.67.178.61 [2. API 설정] |
api [2019/02/16 19:19] samktg [2. 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 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 |