NEXON Open API

메이플스토리

업데이트

중요

메이플스토리 Open API 업데이트 안내

2024.11.21

안녕하세요.

NEXON Open API입니다.

11/21(목) 메이플스토리 Open API 업데이트가 진행되어 상세 내용을 안내 드립니다.

업데이트 내용

API로 제공되는 이미지의 URL 정보가 변경됩니다.

API 명	Schemas 명	변경 Schemas 정보
캐릭터 정보 조회	CharacterBasic	character_image
	CharacterItemEquipment	item_equipment - item_icon item_equipment - item_shape_icon item_equipment_preset_1 ~ 3 - item_icon item_equipment_preset_1 ~ 3 - item_shape_icon dragon_equipment - item_icon dragon_equipment - item_shape_icon mechanic_equipment - item_icon mechanic_equipment - item_shape_icon title - title_icon
	CharacterCashItemEquipment	cash_item_equipment_base - cash_item_icon cash_item_equipment_preset_1 ~ 3 - cash_item_icon additional_cash_item_equipment_base - cash_item_icon additional_cash_item_equipment_preset_1 ~ 3 - cash_item_icon
	CharacterSymbolEquipment	symbol - symbol_icon
	CharacterAndroidEquipment	android_icon android_preset_1 ~ 3 - android_icon android_cash_item_equipment - cash_item_icon
	CharacterPetEquipment	pet_1_icon pet_1_appearance_icon pet_1_equipment - item_icon pet_1_equipment - item_shape_icon pet_2_icon pet_2_appearance_icon
	CharacterSkill	character_skill - skill_icon
	CharacterLinkSkill	character_link_skill - skill_icon character_link_skill_preset_1 ~ 3 - skill_icon character_owned_link_skill - skill_icon character_owned_link_skill_preset_1 ~ 3 - skill_icon pet_2_equipment - item_icon pet_2_equipment - item_shape_icon pet_3_icon pet_3_appearance_icon pet_3_equipment - item_icon pet_3_equipment - item_shape_icon
길드 정보 조회	GuildBasic	guild_skill - skill_icon guild_noblesse_skill - skill_icon

조회된 캐릭터 외형 이미지 URL에 쿼리 파라미터를 사용하여 캐릭터 이미지의 동작이나 감정 표현의 변경이 가능하도록 제공됩니다.
- 적용 대상 Schemas : CharacterBasic - character_image
- 쿼리 파라미터는 API로 조회된 URL 뒤에 물음표(?)와 "Key=value" 쌍을 입력하여 조회합니다.
- 여러 개의 쿼리 파라미터를 전달하려면 파라미터 사이에 앰퍼샌드(&)을 추가하여 하나의 문자열로 입력합니다.
  - 예시 : https://open.api.nexon.com/static/maplestory/character/look/ABCEDFG?action=A00&emotion=E00&width=200&height=200&x=100&y=100
- 캐릭터 외형 이미지에 사용할 수 있는 쿼리 피라미터는 다음과 같습니다.

파라미터 명	파라미터 설명	개발 가이드
action	액션	A00 : stand1(default) A01 : stand2 A02 : walk1 A03 : walk2 A04 : prone A05 : fly A06 : jump A07 : sit
emotion	감정표현	E00 : default (default) E01 : wink E02 : smile E03 : cry E04 : angry E05 : bewildered
wmotion	무기 모션	W00 : 기본 모션(default, 무기 타입에 따른 모션) W01 : 한손 모션 W02 : 두손 모션 W03 : 건 모션
width	가로 길이	배경 크기에 해당함, 96 (default) ~ 1000
height	세로 길이	배경 크기에 해당함, 96 (default) ~ 1000
x	캐릭터의 가로 좌표	좌표 범위 0 < x < width, 0은 왼쪽 시작점에 해당
y	캐릭터의 세로 좌표	좌표 범위 0 < y < height, 0은 상단 시작점에 해당

적용 일시

2024년 11월 21일(목) 오후 2시 적용

많은 관심과 성원 부탁드리며, 더 좋은 서비스로 찾아뵙겠습니다.
감사합니다.

Make fun, create new value | NEXON Open API

이전 글이 없습니다.

메이플스토리

(연장) 메이플스토리 Open API 서비스 점검 안내 (11/21)