Browse Source

Merge branch 'EnkaNetwork:master' into master

pull/24/head
M-307 GitHub 3 years ago
parent
commit
a533d59990
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 7062 additions and 6747 deletions
  1. +1
    -0
      README.md
  2. +2
    -0
      api.md
  3. +239
    -0
      api_chs.md
  4. +1
    -0
      api_es.md
  5. +11
    -7
      api_ja.md
  6. +1372
    -1668
      store/characters.json
  7. +5436
    -5072
      store/loc.json

+ 1
- 0
README.md View File

@@ -8,3 +8,4 @@
* [JA | APIドキュメント](/api_ja.md)
* [ES | Documentación de la API](/api_es.md)
* [TH | เอกสาร API](/api_th.md)
* [CHS | API 文档](/api_chs.md)

+ 2
- 0
api.md View File

@@ -99,6 +99,7 @@ For any additional info about artifacts, check the [Artifacts Data](https://raw.
| :--- | :---------- |
| level | Artifact Level `[1-21]` |
| mainPropId | Artifact Main Stat ID <br /> [MainProps Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) |
| appendPropIdList | List of IDs of the artifact substats <br /> [AppendProp Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryAffixExcelConfigData.json) |

#### flat

@@ -210,6 +211,7 @@ For any additional info about artifacts, check the [Artifacts Data](https://raw.
| FIGHT_PROP_WIND_ADD_HURT | Anemo DMG Bonus |
| FIGHT_PROP_ICE_ADD_HURT | Cryo DMG Bonus |
| FIGHT_PROP_ROCK_ADD_HURT | Geo DMG Bonus |
| FIGHT_PROP_GRASS_ADD_HURT | Dendro DMG Bonus |

## Icons and Images



+ 239
- 0
api_chs.md View File

@@ -0,0 +1,239 @@
简体中文翻译可能并不完全准确。如有必要请参考原文
[api.md](/api.md)

# Enka.Network - API

## 目录

- [入门](#入门)
- [数据结构](#数据结构)
- [定义](#定义)
- [图标和图片](#图标和图片)
- [本地化](#本地化)

## 入门

你可以通过请求这个 URL 获取 JSON 数据 —— `https://enka.network/u/[UID]/__data.json` <br />
例如 https://enka.network/u/700378769/__data.json

## 数据结构

| 名称 | 描述 |
| :--- | :---------- |
| [playerInfo](#playerinfo) | 玩家资料信息 |
| [avatarInfoList](#avatarinfolist) | 正在展示的每个角色的详细信息列表 |

### playerInfo

对于通过 ID 获取角色的基本信息,请前往 [store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)。 <br />
有关任何其他信息,请查看 [Characters Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json)。

| 名称 | 描述 |
| :--- | :--------- |
| nickname | 名称 |
| signature | 签名 |
| worldLevel | 世界等级 |
| namecardId | 资料名片 ID |
| finishAchievementNum | 已解锁成就数 |
| towerFloorIndex | 本期深境螺旋层数 |
| towerLevelIndex | 本期深境螺旋间数 |
| [showAvatarInfoList](#showavatarinfolist) | 角色 ID 与等级的列表 |
| showNameCardIdList | 正在展示的名片 ID 列表 |
| profilePicture.avatarId | 玩家头像的角色 ID |

#### showAvatarInfoList

| 名称 | 描述 |
| :--- | :--------- |
| avatarId | 角色 ID |
| level | 角色等级 |
| costumeId | 角色衣装 ID。请查看 [store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json) 的 `"Costumes"` |

### avatarInfoList

对于通过 ID 获取角色的基本信息,请前往 [store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)。 <br />
有关任何其他信息,请查看 [Characters Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json)。

| 名称 | 描述 |
| :--- | :---------- |
| avatarID | 角色 ID |
| talentIdList | 命之座 ID 列表 <br /> 如果未解锁任何命之座则此数据不存在 |
| [propMap](#propmap) | 角色属性列表 |
| fightPropMap -> `{id: value}` | 角色战斗属性 Map <br />请查看 [ID 定义](#fightprop)|
| skillDepotId | 角色天赋 ID <br />[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"id"`|
| inherentProudSkillList | 固定天赋列表 ID <br />[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
| skillLevelMap -> `{skill_id: level}`| 天赋等级 Map <br /> [Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
| [equipList](#equiplist) | 装备列表:武器、圣遗物 |
| fetterInfo.expLevel | 角色好感等级 |

#### propMap

| 名称 | 描述 |
| :--- | :--------- |
| type | 属性类型, 请查看 [ID 定义](#prop) |
| ival | 忽略它 |
| val | 属性值 |

#### equipList

| 名称 | 描述 |
| :--- | :--------- |
| itemId | 装备 ID <br /> [Artifacts Data](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"` <br /> [Weapons Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/WeaponExcelConfigData.json) -> `"id"` |
| [weapon](#weapon) `[Weapon Only]` | 武器基本信息 |
| [reliquary](#reliquary) `[Artifact Only]` | 圣遗物基本信息 |
| [flat](#flat) | 装备详细信息 |

#### weapon

有关武器的任何其他信息, 请查看 [Weapons Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/WeaponExcelConfigData.json)

| 名称 | 描述 |
| :--- | :---------- |
| level | 武器等级 |
| promoteLevel | 武器突破等级 |
| affixMap | 武器精炼等级 `[0-4]` |


#### reliquary

有关圣遗物的任何其他信息, 请查看 [Artifacts Data](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json)

| 名称 | 描述 |
| :--- | :---------- |
| level | 圣遗物等级 `[1-21]` |
| mainPropId | 圣遗物主属性 ID <br /> [MainProps Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) |
| appendPropIdList | 圣遗物副属性 ID 列表 <br /> [AppendProp Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryAffixExcelConfigData.json) |

#### flat

| 名称 | 描述 |
| :--- | :---------- |
| nameTextHashMap | 装备名的哈希值 <br /> 请查看 [本地化](#本地化) |
| setNameTextHashMap `[Artifact Only]`| 圣遗物套装的名称的哈希值 <br /> 请查看 [本地化](#本地化)|
| rankLevel | 装备稀有度 |
| [reliquaryMainstat](#reliquarymainstat-reliquarysubstats-weaponstats) `[Artifact Only]` | 圣遗物主属性 |
| [reliquarySubstats](#reliquarymainstat-reliquarysubstats-weaponstats) `[Artifact Only]` | 圣遗物副属性列表 |
| [weaponStats](#reliquarymainstat-reliquarysubstats-weaponstats) `[Weapon Only]`| 武器属性列表:基础攻击力、副属性 |
| [itemType](#itemtype) | 装备类别:武器、圣遗物 |
| icon | 装备图标名称 <br /> [图标名称使用方法](#图标和图片)|
| [equipType](#equiptype) `[Artifact Only]` | 圣遗物类型 |

#### reliquaryMainstat, reliquarySubstats, weaponStats

| 名称 | 描述 |
| :--- | :---------- |
| mainPropId / appendPropID | 装备属性名称。请查看 [名称定义](#appendprop)|
| propValue | 属性值 |

## 定义

### Prop

| 类型 | 描述 |
| :--: | :---------- |
| 1001 | 经验值 |
| 1002 | 突破 |
| 4001 | 等级 |

### FightProp

| 类型 | 描述 |
| :--: | :---------- |
| 1 | 基础生命值 |
| 4 | 基础攻击力 |
| 7 | 基础防御力 |
| 20 | 暴击率 |
| 22 | 暴击伤害 |
| 23 | 元素充能效率 |
| 26 | 治疗加成 |
| 27 | 受治疗加成 |
| 28 | 元素精通 |
| 29 | 物理抗性 |
| 30 | 物理伤害加成 |
| 40 | 火元素伤害加成 |
| 41 | 雷元素伤害加成 |
| 42 | 水元素伤害加成 |
| 44 | 风元素伤害加成 |
| 45 | 岩元素伤害加成 |
| 46 | 冰元素伤害加成 |
| 50 | 火元素抗性 |
| 51 | 雷元素抗性 |
| 52 | 水元素抗性 |
| 53 | 草元素抗性 |
| 54 | 风元素抗性 |
| 55 | 岩元素抗性 |
| 56 | 冰元素抗性 |
| 70 | Pyro Enegry Cost |
| 71 | Electro Energy Cost |
| 72 | Hydro Energy Cost |
| 73 | Dendro Energy Cost |
| 74 | Anemo Energy Cost |
| 75 | Cryo Energy Cost |
| 76 | Geo Energy Cost |
| 2000 | 生命值上限 |
| 2001 | 攻击力 |
| 2002 | 防御力 |

### ItemType

| 名称 | 描述 |
| :--- | :---------- |
| ITEM_WEAPON | 武器 |
| ITEM_RELIQUARY | 圣遗物 |

### EquipType

| 名称 | 描述 |
| :--- | :---------- |
| EQUIP_BRACER | 生之花 |
| EQUIP_NECKLACE | 死之羽 |
| EQUIP_SHOES | 时之沙 |
| EQUIP_RING | 空之杯 |
| EQUIP_DRESS | 理之冠 |

### AppendProp

| 名称 | 描述 |
| :--- | :---------- |
| FIGHT_PROP_BASE_ATTACK `[Weapon]` | 基础攻击力 |
| FIGHT_PROP_HP | 生命值 |
| FIGHT_PROP_ATTACK | 攻击力 |
| FIGHT_PROP_DEFENSE | 防御力 |
| FIGHT_PROP_HP_PERCENT | 生命值百分比 |
| 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 | 岩元素伤害加成 |

## 图标和图片

您可以通过 Enka 获取角色、武器和圣遗物的图标,通过 URL `https://enka.network/ui/[icon_name].png`。
通常图标名称以 `"UI_"` 或 `"Skill_"`(对于[角色天赋](#characters-talents-and-consts))为前缀。
例如 https://enka.network/ui/UI_AvatarIcon_Side_Ambor.png


### 武器和圣遗物

前往 [flat](#flat) 并寻找 `icon`。

### 角色,天赋和命座

前往 [store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json) 并通过角色 ID 寻找与 "UI_XXXXXX" 或 "Skill_XXXXXX" 相关的数据。

## 本地化

您可能会注意到 [store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json) 中的 `"NameTextMapHash"`、[flat](#flat) 中的 `"nameTextHashMap"` 和 `"setNameTextHashMap"`,它们可以用作从 [store/loc.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/loc.json) 获取角色、武器和圣遗物的基本的本地化数据的键。

您还可以通过使用属性名称作为键来获取 [AppendProp](#appendprop) 中的本地化数据 —— 例如 `"FIGHT_PROP_HP"`、`"FIGHT_PROP_HEAL_ADD"` 等。

有关名称、描述等的任何其他信息,请查看 [TextMap Data](https://github.com/Dimbreath/GenshinData/tree/master/TextMap),仅包括游戏支持的语言。

+ 1
- 0
api_es.md View File

@@ -102,6 +102,7 @@ Para obtener información adicional sobre los artefactos, revisa los [Datos de l
| :--- | :---------- |
| level | Nivel del artefacto `[1-21]` |
| mainPropId | ID del stat principal <br /> [Datos de los MainProps](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) |
| appendPropIdList | Lista de ids de los stats secundarios del artefacto <br /> [Datos de los AppendProp](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryAffixExcelConfigData.json) |

#### flat



+ 11
- 7
api_ja.md View File

@@ -9,7 +9,7 @@
- [データ構造情報](#データ構造情報)
- [定義](#定義)
- [アイコンと画像](#アイコンと画像)
- [言語情報](#localizations)
- [言語情報](#言語情報)

## 入門

@@ -101,7 +101,8 @@ ID別の文字の基本データについては、[store/characters.json](https:
| 名前 | 説明 |
| :--- | :---------- |
| level | 聖遺物Lv `[1-21]` |
| mainPropId | 聖遺物メインステータスID(?)<br /> [MainProps Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) |
| mainPropId | 聖遺物メインステータスID<br /> [MainProps Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) |
| appendPropIdList | 聖遺物サブステータスIDのリスト<br /> [AppendProp Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryAffixExcelConfigData.json) |

#### flat

@@ -228,9 +229,12 @@ ID別の文字の基本データについては、[store/characters.json](https:

[store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)から"UI_XXXXXX"または"Skill_XXXXXX"を探します

## Localizations
## 言語情報
[store/loc.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/loc.json)で各言語の翻訳文字列を得る事が出来ます。
この時使用されるキー文字列は
* [store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)内の`"NameTextMapHash"`
* [flat](#flat)の`"nameTextHashMap"` `"setNameTextHashMap"`
* [AppendProp](#appendprop) の名前。例:`"FIGHT_PROP_HP"` `"FIGHT_PROP_HEAL_ADD"`
等です

You may notice `"NameTextMapHash"` in [store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json), `"nameTextHashMap"` and `"setNameTextHashMap"` at [flat](#flat) that could be used as a key to get basic localization data of characters, weapons and artifacts from [store/loc.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/loc.json).
Also you can get localization data of [AppendProp](#appendprop) by using property name as a key - `"FIGHT_PROP_HP"`, `"FIGHT_PROP_HEAL_ADD"` etc.

For any additional info about names, descriptions and etc, check the [TextMap Data](https://github.com/Dimbreath/GenshinData/tree/master/TextMap), only includes languages supported by game.
その他の追加情報を[TextMap Data](https://github.com/Dimbreath/GenshinData/tree/master/TextMap)で得る事が出来ます。ゲームでサポートされている言語のみが含まれます。

+ 1372
- 1668
store/characters.json
File diff suppressed because it is too large
View File


+ 5436
- 5072
store/loc.json
File diff suppressed because it is too large
View File


Loading…
Cancel
Save