다른 사람이 제작한 패키지를 활용하거나 API를 직접 사용할 수 있습니다. API 응답을 기반으로 하여 자체적인 데이터 로직을 구성하는 것은 매우 간단합니다.
아래는 API 사용에 대한 몇가지 규칙입니다.
-
데이터베이스를 수집하기 위해 UID를 열거하거나 대규모 요청을 수행하지 마세요. 수많은 UID가 존재하기 때문에 해당 작업을 수행할 수 없습니다. 추후에 일괄적으로 요청이 가능한 API를 제공할 수도 있습니다.
-
요청 주체를 식별하고 필요한 경우 도움을 드릴 수 있도록 요청 헤더에
User-Agent항목을 직접 설정해 주세요. -
UID 엔드포인트에는 유동적인 속도 제한이 있습니다. 요청이 너무 빠르다면 응답 시간이 점차 느려지고 결국엔 HTTP 429 오류를 반환합니다. 따라서 요청 속도를 늦추거나 저에게 연락하셔서 이러한 제한을 늘릴 수 있는지 확인하세요. 그러나 대부분의 경우는 제한에 걸리지 않으며 제한에 걸린다면 비효율적인 코드가 원인일 것입니다.
-
모든 UID 엔드포인트에서는 'ttl' 필드를 반환합니다. 'ttl' 필드는 캐시된 응답이 만료되기까지 남은 초를 의미합니다. 캐시된 데이터가 만료될 때까지 엔드포인트는 동일한 데이터를 반환하므로 'ttl' 필드를 활용하여 불필요한 요청을 방지하세요. 캐시 저장소로 Redis를 추천합니다.
데이터 활용에 어려움이 있으면 Discord 서버에서 도움을 구하세요.
playerInfo, avatarInfoList를 응답합니다. playerInfo는 플레이어 계정의 기본적인 데이터입니다. avatarInfoList가 비어있다면, 해당 플레이어의 캐릭터 상세보기가 비공개 상태거나 전시된 캐릭터가 없다는 의미입니다.
?info 쿼리를 붙이면 playerInfo만 요청할 수 있습니다.
UID 엔드포인트에서는 다음 조건을 충족할 때 owner 항목을 포함합니다:
- 요청한 플레이어가 enka.network 회원 등록이 되어 있음
- 해당 사용자가 자신의 프로필에 UID를 등록함
- 해당 사용자의 원신 계정 소유가 인증됨
- 해당 사용자가 자신의 프로필을 공개 상태로 설정함
사용자 계정에 대한 자세한 내용은 아래를 참고하세요.
앱에서 응답 코드를 적절히 처리하십시오.
400 = 올바르지 않은 UID 포맷
404 = 플레이어가 존재하지 않음 (미호요 서버의 응답)
424 = 게임 점검 중이거나 게임 업데이트 이후 작동할 수 없음
429 = 요청 속도 제한 (enka.network 서버 또는 미호요 서버의 응답)
500 = 서버 오류
503 = 나의 엄청난 실수
웹사이트에서 계정(프로필)을 만들고 여러 원신 계정을 등록하는 것이 가능합니다. 그런 다음, 사용자는 인게임 프로필의 자기 소개에 인증 코드를 입력하여 계정 소유를 인증할 수 있습니다.
유저는 임의의 이름으로 빌드를 스냅샷 할 수 있습니다.
유저 정보를 반환합니다.
원신 계정과 계정의 메타데이터 목록 "hoyos"를 반환합니다. 계정 소유가 인증되었고 공개 상태인 경우에만 반환합니다. (유저는 계정을 비공개 상태로 설정할 수 있으며, 소유가 인증되지 않은 계정은 기본적으로 비공개 상태입니다)
응답의 각 키는 hoyo의 고유 식별자로, 캐릭터/빌드 정보를 얻기 위한 추가 요청에 사용하면 됩니다.
hoyo에 대한 메타데이터를 반환합니다.
https://enka.network/api/profile/Algoinde/hoyos/4Wjv2e/builds/
hoyo에 대한 저장된 빌드를 반환합니다. 이것은 객체 형식으로 이루어진 배열이며, 각 키는 캐릭터의 'avatarId'를 의미하고, 키의 순서는 특정한 순서를 의미하는 것이 아니라 특정 캐릭터에 대한 서로 다른 빌드입니다. (그래도 진열 순서를 알 수 있도록 order 항목이 존재합니다)
빌드에 live: true 항목이 있으면 "저장된" 빌드가 아니라 "새로고침"을 클릭했을 때 진열장에서 가져온 것임을 의미합니다. 새로고침을 클릭했을 때는 live 빌드가 모두 사라지고 새 빌드가 만들어집니다. 새로고침은 유저만 수행할 수 있습니다. 이 데이터는 최신 데이터가 아닙니다.
UID 엔드포인트에서 설명한 대로, UID 엔드포인트에 요청할 때 owner 객체를 얻을 수 있습니다. 이 객체를 다음과 같이 활용할 수 있습니다:
https://enka.network/api/profile/{owner.username}/hoyos/{owner.hash}/builds/
| Name | Description |
|---|---|
| playerInfo | 프로필 정보 |
| avatarInfoList | 캐릭터 진열장의 모든 캐릭터별 세부 정보 |
캐릭터 ID별 기본적인 데이터는 store/characters.json을 참고하세요.
더 상세한 정보는 Characters Data을 참고하세요.
| Name | Description |
|---|---|
| nickname | 플레이어 닉네임 |
| signature | 플레이어 자기 소개 |
| worldLevel | 플레이어 월드 레벨 |
| namecardId | 명함 ID |
| finishAchievementNum | 획득한 업적 개수 |
| towerFloorIndex | 나선 비경 - 층 번호 |
| towerLevelIndex | 나선 비경 - 방 번호 |
| showAvatarInfoList | 캐릭터 ID 및 레벨 목록 |
| showNameCardIdList | 진열된 명함 ID 목록 |
| profilePicture.avatarId | 프로필 사진 캐릭터 ID |
| Name | Description |
|---|---|
| avatarId | 캐릭터 ID |
| level | 캐릭터 레벨 |
| costumeId | 캐릭터 코스튬 ID (store/characters.json에서 "Costumes" 항목 참고) |
캐릭터 ID별 기본적인 데이터는 store/characters.json을 참고하세요.
더 상세한 정보는 Characters Data을 참고하세요.
| Name | Description |
|---|---|
| avatarID | 캐릭터 ID |
| talentIdList | 운명의 자리 ID 목록. 해금된 운명의 자리가 없으면 항목이 비어 있습니다. |
| propMap | 캐릭터 속성 맵 |
fightPropMap -> {id: value} |
캐릭터의 전투 능력치에 대한 맵. ID 정의를 참고하세요. |
| skillDepotId | 캐릭터 스킬셋 ID Skills Data -> "id" |
| inherentProudSkillList | 해금된 특성 목록 Skills Data -> "inherentProudSkillOpens" |
skillLevelMap -> {skill_id: level} |
스킬 레벨 맵 Skills Data -> "inherentProudSkillOpens" |
| equipList | 장착한 무기, 성유물 목록 |
| fetterInfo.expLevel | 캐릭터 호감도 레벨 |
| Name | Description |
|---|---|
| type | 속성 타입 ID (속성 정의) |
| ival | (무시) |
| val | 수치 |
| Name | Description |
|---|---|
| itemId | 장비 ID Artifacts Data(성유물 데이터) -> "id" Weapons Data(무기 데이터) -> "id" |
weapon [무기 전용] |
무기 정보 |
reliquary [성유물 전용] |
성유물 정보 |
| flat | 장비 상세 정보 |
무기에 대한 자세한 정보는 Weapons Data을 참고하세요.
| Name | Description |
|---|---|
| level | 무기 레벨 |
| promoteLevel | 무기 돌파 레벨 |
| affixMap | 무기 재련 레벨 [0-4] |
성유물에 대한 자세한 정보는 Artifacts Data을 참고하세요.
| Name | Description |
|---|---|
| level | 성유물 레벨 [1-21] |
| mainPropId | 성유물 주 옵션 ID MainProps Data(주 옵션 데이터) |
| appendPropIdList | 성유물 부 옵션 ID 목록 AppendProp Data(부 옵션 데이터) |
| Name | Description |
|---|---|
| nameTextHashMap | 장비 이름 해시 현지화 확인 |
setNameTextHashMap [성유물 전용] |
성유물 세트 이름 해시 현지화 확인 |
| rankLevel | 장비 등급 (n성) |
reliquaryMainstat [성유물 전용] |
성유물 주 옵션 |
reliquarySubstats [성유물 전용] |
성유물 부 옵션 목록 |
weaponStats [무기 전용] |
무기 능력치 목록: 기초 공격력, 부 옵션 |
| itemType | 장비 타입: 무기 또는 성유물 |
| icon | 장비 아이콘 이름 활용 |
equipType [성유물 전용] |
성유물 장착 분류 |
| Name | Description |
|---|---|
| mainPropId / appendPropID | 장비 옵션의 이름 (appendProp) |
| propValue | 수치 |
| Type | Description |
|---|---|
| 1001 | 경험치 |
| 1002 | 돌파 단계 |
| 4001 | 레벨 |
| Type | Description |
|---|---|
| 1 | 기초 HP |
| 2 | HP |
| 3 | HP% |
| 4 | 기초 공격력 |
| 5 | 공격력 |
| 6 | 공격력% |
| 7 | 기초 방어력 |
| 8 | 방어력 |
| 9 | 방어력% |
| 10 | 기초 이동 속도 |
| 11 | 이동 속도% |
| 20 | 치명타 확률 |
| 22 | 치명타 피해 |
| 23 | 원소 충전 효율 |
| 26 | 치유 보너스 |
| 27 | 받는 치유 보너스 |
| 28 | 원소 마스터리 |
| 29 | 물리 내성 |
| 30 | 물리 피해 보너스 |
| 40 | 불 원소 피해 보너스 |
| 41 | 번개 원소 피해 보너스 |
| 42 | 물 원소 피해 보너스 |
| 43 | 풀 원소 피해 보너스 |
| 44 | 바람 원소 피해 보너스 |
| 45 | 바위 원소 피해 보너스 |
| 46 | 얼음 원소 피해 보너스 |
| 50 | 불 원소 내성 |
| 51 | 번개 원소 내성 |
| 52 | 물 원소 내성 |
| 53 | 풀 원소 내성 |
| 54 | 바람 원소 내성 |
| 55 | 바위 원소 내성 |
| 56 | 얼음 원소 내성 |
| 70 | 필요 불 원소 에너지 |
| 71 | 필요 번개 원소 에너지 |
| 72 | 필요 물 원소 에너지 |
| 73 | 필요 풀 원소 에너지 |
| 74 | 필요 바람 원소 에너지 |
| 75 | 필요 얼음 원소 에너지 |
| 76 | 필요 바위 원소 에너지 |
| 80 | 재사용 대기시간 감소 |
| 81 | 보호막 강화 |
| 1000 | 현재 불 원소 에너지 |
| 1001 | 현재 번개 원소 에너지 |
| 1002 | 현재 물 원소 에너지 |
| 1003 | 현재 풀 원소 에너지 |
| 1004 | 현재 바람 원소 에너지 |
| 1005 | 현재 얼음 원소 에너지 |
| 1006 | 현재 바위 원소 에너지 |
| 1010 | 현재 HP |
| 2000 | 최대 HP |
| 2001 | 공격력 |
| 2002 | 방어력 |
| 2003 | 이동 속도 |
| 3025 | 원소 반응 치명타 확률 |
| 3026 | 원소 반응 치명타 피해 |
| 3027 | 원소 반응 (과부하) 치명타 확률 |
| 3028 | 원소 반응 (과부하) 치명타 피해 |
| 3029 | 원소 반응 (확산) 치명타 확률 |
| 3030 | 원소 반응 (확산) 치명타 피해 |
| 3031 | 원소 반응 (감전) 치명타 확률 |
| 3032 | 원소 반응 (감전) 치명타 피해 |
| 3033 | 원소 반응 (초전도) 치명타 확률 |
| 3034 | 원소 반응 (초전도) 치명타 피해 |
| 3035 | 원소 반응 (연소) 치명타 확률 |
| 3036 | 원소 반응 (연소) 치명타 피해 |
| 3037 | 원소 반응 (빙결 (쇄빙)) 치명타 확률 |
| 3038 | 원소 반응 (빙결 (쇄빙)) 치명타 피해 |
| 3039 | 원소 반응 (개화) 치명타 확률 |
| 3040 | 원소 반응 (개화) 치명타 피해 |
| 3041 | 원소 반응 (발화) 치명타 확률 |
| 3042 | 원소 반응 (발화) 치명타 피해 |
| 3043 | 원소 반응 (만개) 치명타 확률 |
| 3044 | 원소 반응 (만개) 치명타 피해 |
| 3045 | 기초 원소 반응 치명타 확률 |
| 3046 | 기초 원소 반응 치명타 피해 |
| Name | Description |
|---|---|
| ITEM_WEAPON | 무기 |
| ITEM_RELIQUARY | 성유물 |
| Name | Description |
|---|---|
| EQUIP_BRACER | 생명의 꽃 |
| EQUIP_NECKLACE | 죽음의 깃털 |
| EQUIP_SHOES | 시간의 모래 |
| EQUIP_RING | 공간의 성배 |
| EQUIP_DRESS | 이성의 왕관 |
| Name | Description |
|---|---|
FIGHT_PROP_BASE_ATTACK [Weapon] |
기초 공격력 |
| FIGHT_PROP_HP | HP |
| FIGHT_PROP_ATTACK | 공격력 |
| FIGHT_PROP_DEFENSE | 방어력 |
| FIGHT_PROP_HP_PERCENT | HP% |
| FIGHT_PROP_ATTACK_PERCENT | 공격력% |
| FIGHT_PROP_DEFENSE_PERCENT | 방어력% |
| FIGHT_PROP_CRITICAL | 치명타 확률 |
| FIGHT_PROP_CRITICAL_HURT | 치명타 피해 |
| FIGHT_PROP_CHARGE_EFFICIENCY | 원소 충전 효율 |
| FIGHT_PROP_HEAL_ADD | 치유 보너스 |
| FIGHT_PROP_ELEMENT_MASTERY | 원소 마스터리 |
| FIGHT_PROP_PHYSICAL_ADD_HURT | 물리 피해 보너스 |
| FIGHT_PROP_FIRE_ADD_HURT | 불 원소 피해 보너스 |
| FIGHT_PROP_ELEC_ADD_HURT | 번개 원소 피해 보너스 |
| FIGHT_PROP_WATER_ADD_HURT | 물 원소 피해 보너스 |
| FIGHT_PROP_WIND_ADD_HURT | 바람 원소 피해 보너스 |
| FIGHT_PROP_ICE_ADD_HURT | 얼음 원소 피해 보너스 |
| FIGHT_PROP_ROCK_ADD_HURT | 바위 원소 피해 보너스 |
| FIGHT_PROP_GRASS_ADD_HURT | 풀 원소 피해 보너스 |
캐릭터, 무기, 성유물 등의 아이콘은 https://enka.network/ui/[icon_name].png 경로로 제공됩니다. 운명의 자리 아이콘 이름은 일반적으로 "UI_" 또는 "Skill_"로 시작합니다.
예시: https://enka.network/ui/UI_AvatarIcon_Side_Ambor.png
flat에서 icon 항목을 활용하세요.
store/characters.json에서 캐릭터 ID별로 "UI_XXXXXX" 또는 "Skill_XXXXXX" 항목을 활용하세요.
store/characters.json에서 "NameTextMapHash", flat에서 "nameTextHashMap" 또는 "setNameTextHashMap"가 존재할 수 있으며 이는 캐릭터, 무기 및 성유물의 현지화 데이터를 가져오는 키로 사용할 수 있습니다.
또한 전투 능력치 이름을 키로 사용하여 AppendProp의 현지화 데이터를 얻을 수 있습니다. ("FIGHT_PROP_HP", "FIGHT_PROP_HEAL_ADD" 등)
이름, 설명 등 현지화된 텍스트에 대한 자세한 정보는 TextMap Data를 참고하세요.
TS/JS - https://www.npmjs.com/package/enkanetwork.js - Jelosus1
TS/JS - https://github.com/yuko1101/enka-network-api - yuko1101
Rust - https://github.com/eratou/enkanetwork-rs - eratou
Python - https://github.com/mrwan200/enkanetwork.py - mrwan200