액션쾌감!!! 던전앤파이터!

던파매거진

오픈 API in 던파ON!

2017.12.26 00:00 47,564

던전앤파이터의 오픈 API 서비스를 알고 계신가요?

오픈 API는 게임 내 다양한 정보를 외부 개발자가 쉽게 이용할 수 있도록 제공되는 서비스예요.

던파ON에서 제공하는 기능 중 상당 부분은 바로 이 오픈 API를 사용하고 있답니다!

그 말은 즉, 여러분도 마음만 먹으면 던파ON 같은, 또는 더 참신하고 반짝거리는 아이디어가 가득한

여러분만의 앱을 만들 수 있다는 의미예요~

던파ON에선 캐릭터와 관련된 정보 검색과

경매장 아이템 검색/조회 에 오픈 API가 사용되었는데요.

그 중에서 캐릭터와 관련된 던파ON의 캐릭터 검색/조회 기능에 사용된 API를 소개 해드릴게요~^^

캐릭터 검색 API

던파ON을 이용해서 캐릭터를 검색하신 적 있으신가요?

캐릭터를 검색하고, 해당 캐릭터의 정보를 확인할 수 있는 기능에 오픈 API가 사용되었답니다.

그럼 어떻게 사용되었는지 보여드릴게요.

던파ON에서는 이렇게 서버를 정하고 검색을 원하는 캐릭터 이름을 입력하면,

원하는 이름이 들어간 해당 서버의 캐릭터들을 조회할 수 있는데요.

이 기능엔 캐릭터 검색 API가 사용되었습니다.

https://api.neople.co.kr/df/servers/(서버 영문 명칭)/characters?characterName=(캐릭터 이름)&limit=200&wordType=full

이처럼 캐릭터 검색 API를 사용하여 정보를 요청하면 관련된 데이터 컬럼을 얻을 수 있고,

해당 데이터 컬럼을 토대로 화면에 정보를 노출할 수 있습니다.

캐릭터 검색의 데이터 컬럼은 아래와 같이 구성되어 있어요.

컬럼명	설명
characterId	캐릭터 고유 코드
characterName	캐릭터 명
level	레벨
jobId	캐릭터 직업 고유 코드
jobGrowId	캐릭터 각성 직업 고유 코드
jobName	캐릭터 직업 명칭
jobGrowName	캐릭터 각성 직업 명칭

API 페이지에서 조건에 맞춰 URL을 입력하고 요청을 누르면 결과를 볼 수 있어서 저도 눌러 봤는데요.

{"rows":[{
"characterId":"캐릭터 고유 코드",
"characterName":"쑤남",
"level":90,
"jobId":"캐릭터 직업 고유 코드",
"jobGrowId":"캐릭터 각성 직업 고유 코드",
"jobName":"격투가(남)",
"jobGrowName":"패황“
……..
}]}

이렇...게... Response Body 가... 출력되었어요...

흠흠...

저도 잘 아는 건 아니지만 그래도 쑤남이라는 캐릭터명과 레벨,

전직 정보 등을 보여주고 있다는 건 알 수 있는데요.

저 정보들을 금손을 가진 모험가 여러분이 보기 좋게 뚝딱뚝딱 가공하면

던파ON의 캐릭터 검색 결과와 같은 화면이 되는 거죠~

어때요? 참 쉽죠?*^---------------------------^*

그럼 다른 기능들도 계속 살펴볼까요?

캐릭터 기본 정보 API

던파ON의 캐릭터 검색을 통해 나온 결과에는 이름과 레벨, 직업만 노출되는데요.

검색 결과 창에서 원하는 캐릭터를 손끝으로 톡! 누르면 해당 캐릭터의 기본 정보를 살펴볼 수 있어요.

이 역시 캐릭터의 기본 정보를 요청하는 API를 사용했답니다.

검색 API보다 요청 URL 구성이 훨씬 간단한데요.

https://api.neople.co.kr/df/servers/(서버 명칭)/characters/(캐릭터 고유 코드)

이렇게 서버와 캐릭터 코유 코드를 통해 기본적인 캐릭터의 정보를 요청할 수 있어요.

캐릭터 검색 기능을 통해 요청한 캐릭터의 고유 코드를 활용할 수 있겠죠?

캐릭터 능력치 정보 조회 API

그 다음은 캐릭터 능력치를 조회하는 API에 대해 소개 해드릴게요.

던파ON의 캐릭터 정보 조회 페이지에서 능력치를 누르면

해당 캐릭터의 상세 능력치를 확인할 수 있는데요.

이 기능 역시 오픈 API인 캐릭터의 '능력치 정보' 조회 API를 사용했습니다.

https://api.neople.co.kr/df/servers/(서버 명칭)/characters/(캐릭터 고유 코드)/status

오픈 API를 통해 정보를 요청하면 캐릭터에 적용된 모험단 버프 데이터도 얻을 수 있어서

버프 레벨에 맞는 능력치 정보를 포함하여 보여줄 수 있답니다.

캐릭터 장착 정보 API

그리고 캐릭터 기본 정보에는 능력치 외에도 장착 장비, 아바타, 크리쳐, 휘장 조회 버튼이 있는데요.

해당 조회 기능 역시 모두 오픈 API를 사용한 기능이에요.

조회를 원하는 메뉴를 클릭하면 캐릭터가 장착하고 있는 장비와 아바타, 크리쳐, 휘장에 대한 정보를 확인할 수 있어요.

4개의 요청 URL은 비슷한 구조로 이루어져 있어서 알아보기 더욱 쉬우실 것 같아요.

그럼 이번엔 사용된 오픈 API의 요청 URL부터 먼저 살펴보실까요?

캐릭터 '장착 장비' 조회
https://api.neople.co.kr/df/servers/(서버 명칭)/characters/(캐릭터 고유 코드)/equip/equipment

캐릭터 '장착 아바타' 조회
https://api.neople.co.kr/df/servers/(서버 명칭)/characters/(캐릭터 고유 코드)/equip/avatar

캐릭터 '장착 크리쳐' 조회
https://api.neople.co.kr/df/servers/(서버 명칭)/characters/(캐릭터 고유 코드)/equip/creature

캐릭터 '장착 휘장' 조회
https://api.neople.co.kr/df/servers/(서버 명칭)/characters/(캐릭터 고유 코드)/equip/flag