API 키 발급 방법 — 길드워2 입문 가이드

API 키가 뭔가요?

아레나넷은 길드워2 계정 데이터(인벤토리, 골드, 업적, 캐릭터 장비 등)를 외부 사이트나 앱에서 읽을 수 있도록 공개 API를 제공합니다. API 키(Application Programming Interface Key)는 이 API에 접근할 때 사용하는 일종의 출입증입니다.

API 키를 외부 도구에 입력하면, 그 도구는 아레나넷 서버에 "이 키를 가진 사용자의 데이터를 줘"라고 요청합니다. 아레나넷은 키가 유효하면 허용된 범위의 데이터만 돌려줍니다. 로그인 비밀번호와는 별개이며, 키를 통해서는 게임 조작이나 계정 설정 변경이 불가능합니다.

비밀번호와 다른 점
API 키는 데이터를 읽기만 할 수 있고, 캐릭터 조작·아이템 거래·계정 설정 변경 등은 API로 불가능합니다. 단, 키 자체는 타인에게 노출되지 않도록 주의하세요.

어디에 쓰이나요?

API 키를 활용하는 대표적인 외부 도구들입니다.

GW2Efficiency

전체 계정의 인벤토리·은행·캐릭터 장비·업적을 한눈에 볼 수 있는 가장 대표적인 도구. 보유 아이템의 총 가치 계산, 제작 레시피 확인, 전설 장비 진행도 추적 등에 활용합니다.

GW2 공식 위키 / armory

일부 위키 기능과 공식 armory에서 캐릭터 빌드·장비를 외부에 공유하거나 확인할 때 사용합니다.

빌드·DPS 시뮬레이터

현재 내 장비와 특성을 기반으로 DPS 시뮬레이션을 돌리거나, 빌드 개선 제안을 받을 수 있는 도구들에서 사용합니다.

길드 관리 도구

길드 로그, 멤버 기여도, 창고 내역 등을 열람하는 길드 관리용 봇이나 웹사이트에서 사용합니다.

GW2 공식 위키 — 마스터리 언락 확인

위키의 마스터리 페이지에 API 키를 입력하면 내가 아직 해금하지 못한 마스터리를 별도로 표시해줍니다. 어떤 마스터리가 남았는지 한눈에 파악하기 매우 편리합니다. 업적 페이지에서도 마찬가지로 미완료 업적을 구분해 보여줍니다.

Discord 봇

GW2 관련 디스코드 서버의 봇에 키를 등록하면 캐릭터 인증·업적 확인·거래소 가격 알림 등을 받을 수 있습니다.

권한(Permission) 종류

API 키를 생성할 때 어떤 데이터에 접근을 허용할지 권한을 직접 선택할 수 있습니다. 필요한 권한만 체크해 발급하면 더 안전합니다.

account

계정 기본 정보(닉네임, 세계, 가입일 등). 거의 모든 도구에서 필수로 요구합니다.

characters

캐릭터 목록, 장비, 스킬·특성 빌드, 레벨 등. GW2Efficiency나 빌드 분석 도구에 필요합니다.

inventories

캐릭터 인벤토리, 은행, 재료 창고 내용. 보유 아이템 가치 계산에 필요합니다.

wallet

골드, 카르마, 라우렐 등 지갑 내 화폐 잔액. 재산 추적에 사용합니다.

progression

업적, 마스터리, 타이틀 진행 상황. 업적 추적 도구에 필요합니다.

tradingpost

거래소 현재 입찰·판매 내역, 거래 이력. 거래소 분석 도구에 사용합니다.

guilds

가입된 길드 목록 및 길드 로그. 길드 관리 도구에서 요구합니다.

builds

저장된 빌드 템플릿 목록. 빌드 공유·분석 도구에 사용합니다.

unlocks

해금된 스킨, 레시피, 미니 등의 목록. 수집 추적 도구에 사용합니다.

왼쪽 주황 테두리: 대부분의 도구에서 필요한 권한 / 회색 테두리: 특정 도구에서 추가로 요구하는 권한

API 키 발급 방법 (단계별)

1

공식 계정 페이지 접속

웹 브라우저에서 account.arena.net 에 접속합니다. 길드워2 계정으로 로그인하세요 (게임 로그인과 동일한 이메일·비밀번호).

2

Applications 메뉴 클릭

로그인 후 상단 메뉴 또는 좌측 사이드바에서 Applications 항목을 클릭합니다. 이 페이지에서 발급된 모든 API 키를 관리할 수 있습니다.

3

New Key 버튼 클릭

New Key 버튼을 눌러 새 키 생성 화면을 엽니다.

4

키 이름 입력

어떤 용도로 만든 키인지 기억하기 쉬운 이름을 입력합니다. 예: GW2Efficiency, Discord Bot, 개인 용도 등. 도구별로 키를 따로 만들어두면 나중에 특정 도구의 접근만 끊을 때 편합니다.

5

필요한 권한 체크

사용하려는 도구가 요구하는 권한을 체크합니다. 귀찮으면 그냥 all을 체크해서 전체 권한으로 발급하는 게 가장 편합니다. 필요한 권한만 선택하고 싶다면 아래 권한 종류 표를 참고하세요.

6

Create API Key 클릭

Create API Key 버튼을 누르면 긴 문자열(API 키)이 생성됩니다. 생성 후에도 account.arena.net → Applications에서 언제든지 다시 확인할 수 있습니다.

7

키 메모 후 외부 도구에 붙여넣기

발급한 키를 메모장 등에 따로 저장해두면 편합니다. 새 도구를 쓸 때마다 account.arena.net에 다시 들어가지 않고 바로 붙여넣을 수 있습니다. GW2Efficiency 등 사용하려는 도구의 API Key 입력란에 키를 붙여넣으면 완료됩니다. 이후 해당 도구에서 계정 데이터를 읽어올 수 있습니다.

키 보안 및 관리

API 키는 타인에게 절대 노출하지 마세요
키를 가진 사람은 허용된 권한 범위 내에서 내 계정 데이터를 마음대로 조회할 수 있습니다. 스크린샷·방송 화면에도 노출되지 않도록 주의하세요.

도구별로 별도의 키를 발급하세요. 특정 도구가 더 이상 신뢰할 수 없게 되면 그 키만 삭제하면 됩니다.
불필요한 권한은 체크하지 않습니다. 필요한 권한 최소한으로 발급하는 것이 안전합니다.
사용하지 않는 키는 삭제하세요. account.arena.net → Applications에서 키 옆의 삭제 버튼으로 즉시 폐기할 수 있습니다.
키가 노출됐다고 의심되면 즉시 해당 키를 삭제하고 새로 발급하면 됩니다. 계정 비밀번호 변경은 불필요합니다.

API 키 — 내 계정을 외부 도구에 연결하기

API 키가 뭔가요?

어디에 쓰이나요?

권한(Permission) 종류

API 키 발급 방법 (단계별)

키 보안 및 관리