오픈 API in 던파ON!
2017.12.26 00:00 47,488
던전앤파이터의 오픈 API 서비스를 알고 계신가요?
캐릭터 검색 API |
https://api.neople.co.kr/df/servers/(서버 영문 명칭)/characters?characterName=(캐릭터 이름)&limit=200&wordType=full
컬럼명 | 설명 |
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
한눈에 봐도 다른 점이 눈에 보일 것 같은데요.
네, 바로 빨간색으로 표시한 부분만 해당 조회 목적에 맞춰 바뀌고,
나머지 부분은 동일하게 구성되어 있어요.
그래서 이해하기도 쉽고, 사용하기도 쉽답니다.
그럼 이제 던파ON을 통해 API를 어떻게 활용했는 지 간단하게 알아볼까요?
≫ 캐릭터 '장착 장비' 조회
캐릭터 '장착 장비' 조회 API를 사용하면 이렇게 캐릭터가 장착한 아이템의 이름 뿐만이 아니라
세트 이름, 희귀도, 강화, 재련 수치도 보여주고 있어요.
≫ 캐릭터 '장착 아바타' 조회
아바타 역시, 캐릭터의 '장착 아바타' 조회 API를 사용하여
소켓에 장착된 엠블렘의 정보와 선택 능력치까지 던파ON을 통해 보여드리고 있습니다.
≫ 캐릭터 '장착 크리쳐' 조회
던파ON은 캐릭터의 '장착 크리쳐' 조회 API를 사용하여
해당 캐릭터가 사용 중인 크리쳐의 이름을 제공하고 있어요.
그 외에도 API를 통해 크리쳐의 오버스킬 정보나 장착 아티펙트 정보 등의 데이터도 가져올 수 있기 때문에
던파ON과 다른 방식으로 데이터를 활용하실 수도 있지 않을까요? :D
≫ 캐릭터 '장착 휘장' 조회
던파ON에 사용된 캐릭터의 '장착 휘장' 조회 API도 크리쳐와 마찬가지로
장착된 휘장의 이름뿐 아니라 아이템 희귀도와 강화 수치, 능력치 등의 데이터를 제공해 주고 있답니다.
지금까지 오픈 API를 활용한 던파ON의 기능을 알려드렸는데요.
던파ON에 많은 API가 사용되었지만 사실 API가 제공하는 모든 정보를 사용한 것은 아니에요.
사용하지 않은 정보들도, 만들지 않은 기능들도 존재하는데요.
그 부분을 눈치 채셨다면, 혹은 오픈 API만 있으면 이런 기능도 가능할 것 같다...! 라는 생각이 드셨다면
지금 바로 오픈 API 안내 페이지로 가보시는 건 어떨까요?^^
던파의 오픈 API를 활용해서 모험가 여러분이 반짝반짝한 아이디어로
멋지고 다양한 애플리케이션을 개발하셨으면 좋겠어요!
만드시면 제일 먼저 던파에 소개시켜 주시기~♥
약속이에요!