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

API 키가 뭔가요?

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

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

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

어디에 쓰이나요?

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

GW2Efficiency

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

GW2 공식 위키: 업적 진행도

API 연동을 지원하는 위키 페이지에서 내가 완료한 업적과 아직 남은 항목을 구분해 볼 수 있습니다.

gw2crafts.net: 보유 재료 반영

제작 레벨업 가이드에 은행·재료 창고의 보유 재료와 해금한 레시피를 반영할 때 사용합니다. API 키 없이도 기본 가이드는 볼 수 있습니다.

길드 관리 도구

길드 명단·공지·활동 기록을 조회하는 봇이나 웹사이트에서 사용합니다. 조회할 수 있는 기록은 API 권한과 게임 안 길드 권한에 따라 다릅니다.

GW2 공식 위키: 마스터리 포인트 업적 확인

Mastery point unlocks 페이지에 키를 적용하면 완료한 마스터리 포인트 업적이 회색으로 표시됩니다. 남은 업적과 획득 조건을 골라 보기에 편합니다.

Discord 봇

봇이 지원하면 계정·캐릭터 소유 확인과 업적 조회 등에 사용할 수 있습니다. 거래소의 공개 가격을 조회하는 것만으로는 개인 API 키가 필요하지 않습니다.

권한(Permission) 종류

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

account

모든 키에 필수인 기본 권한입니다. 계정 이름·ID, 가입일, 가입 길드, 배정된 WvW 팀 등의 정보를 제공합니다.

characters

캐릭터 이름·레벨·종족·직업 등의 정보입니다. 장비·빌드나 가방 조회에는 해당 기능의 추가 권한도 필요합니다.

inventories

은행·재료 창고·캐릭터 가방과 장비 정보입니다. 캐릭터별 조회에는 characters 등 필요한 권한도 함께 요구됩니다.

wallet

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

progression

업적·스토리·마스터리 등 PvE 진행 정보입니다. 위키 업적 완료 표시에도 필요합니다.

tradingpost

현재 대기 중인 구매·판매 주문과 최근 최대 90일의 거래 이력입니다.

guilds

길드 명단·공지·기록 등의 정보입니다. API와 게임 안 길드 권한에 따라 조회 범위가 다릅니다. 가입 길드 목록 자체는 account 권한으로도 조회합니다.

builds

각 게임 모드에 장착한 특성화·특성·스킬·장비 정보입니다. 캐릭터별 조회에는 characters 권한도 필요합니다.

unlocks

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

pvp

PvP 통계·경기 이력·보상 트랙 진행도·커스텀 아레나 정보입니다.

wvw

선택한 WvW 길드와 배정 팀을 조회합니다.

테두리 색과 관계없이, 사용할 도구가 요구하는 권한을 기준으로 선택하세요. account는 모든 키에 포함됩니다.

API 키 발급 방법 (단계별)

1

공식 계정 페이지 접속

웹 브라우저에서 account.arena.net/applications에 접속해 로그인하세요. ArenaNet 계정은 이메일·비밀번호를 쓰고, Steam 계정은 Sign in through Steam을 선택합니다.

2

New Key 버튼 클릭

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

3

키 이름 입력

GW2Efficiency, Discord Bot처럼 용도가 보이는 이름을 쓰세요. 키를 받은 도구도 이 이름을 볼 수 있으므로 개인정보는 넣지 마세요. 도구별로 키를 나누면 특정 도구의 접근만 끊기 편합니다.

4

필요한 권한 체크

도구가 요구하는 권한을 체크하세요. 위키 업적 확인에는 기본 account와 progression이 필요합니다. 발급한 키의 권한은 나중에 바꿀 수 없으므로, 필요한 권한이 달라지면 새 키를 만드세요.

5

Create API Key 클릭

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

6

키 복사 후 외부 도구에 붙여넣기

키를 복사해 사용할 도구의 API Key 입력란에 붙여넣으세요. 다시 필요하면 account.arena.net → Applications에서 확인할 수 있습니다. 따로 보관하려면 비밀번호 관리자처럼 접근을 보호할 수 있는 곳에 저장하세요.

키 보안 및 관리

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

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

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

API 키가 뭔가요?

어디에 쓰이나요?

권한(Permission) 종류

API 키 발급 방법 (단계별)

키 보안 및 관리