Browse Source

Merge pull request #3 from EnkaNetwork/master

boop
pull/14/head
ExLin GitHub 4 years ago
parent
commit
dfaa0df748
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 717 additions and 2 deletions
  1. +4
    -1
      README.md
  2. +1
    -1
      api.md
  3. +237
    -0
      api_es.md
  4. +236
    -0
      api_ja.md
  5. +239
    -0
      api_th.md

+ 4
- 1
README.md View File

@@ -4,4 +4,7 @@
> Fetch data from your Character Showcase and display a build card, instantly.


[API docs](/api.md)
* [API docs](/api.md)
* [JA | APIドキュメント](/api_ja.md)
* [ES | Documentación de la API](/api_es.md)
* [TH | เอกสาร API](/api_th.md)

+ 1
- 1
api.md View File

@@ -36,7 +36,7 @@ For any additional info, check the [Characters Data](https://github.com/Dimbreat
| towerLevelIndex | Abyss Floor's Chamber |
| [showAvatarInfoList](#showavatarinfolist) | List of Character IDs and Levels |
| showNameCardIdList | List of Namecard IDs |
| profilePicture.avatarID | Character ID of Profile Picture |
| profilePicture.avatarId | Character ID of Profile Picture |

#### showAvatarInfoList



+ 237
- 0
api_es.md View File

@@ -0,0 +1,237 @@
Esta traducción puede ser inexacta. Consulta el texto original si es necesario.
[api.md](/api.md)

# Enka.Network - API

## Tabla de Contenidos

- [Empezando](#empezando)
- [Información sobre la estructura de los datos](#información-sobre-la-estructura-de-los-datos)
- [Definiciones](#definiciones)
- [Iconos e Imágenes](#iconos-e-imágenes)
- [Localizaciones](#localizaciones)

## Empezando

Puedes obtener datos en formato JSON haciendo una solicitud a la URL - `https://enka.network/u/[UID]/__data.json` <br />
Por ejemplo https://enka.network/u/700378769/__data.json

## Información sobre la estructura de los datos

| Nombre | Descripción |
| :--- | :---------- |
| [playerInfo](#playerinfo) | Información del Perfil |
| [avatarInfoList](#avatarinfolist) | Lista con detallada información sobre cada personaje que muestras en el perfil |

### playerInfo

Para obtener datos básicos de personajes por la ID, ve a [store/characters.json](/store/characters.json). <br />
Para obtener información adicional, revisa los [Datos de Personajes](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json).

| Nombre | Descripción |
| :--- | :--------- |
| nickname | Nombre del jugador |
| signature | Firma del perfil |
| worldLevel | Nivel de mundo del jugador |
| namecardId | ID de la tarjeta de presentación del perfil |
| finishAchievementNum | Número de logros completados |
| towerFloorIndex | Piso del abismo |
| towerLevelIndex | Cámara del piso del abismo |
| [showAvatarInfoList](#showavatarinfolist) | Lista de IDs y niveles de los personajes |
| showNameCardIdList | Lista de IDs de las tarjetas de presentación |
| profilePicture.avatarID | ID del personaje de la foto de perfil |

#### showAvatarInfoList

| Nombre | Descripción |
| :--- | :--------- |
| avatarId | ID del personaje |
| level | Nivel del personaje |
| costumeId | ID de la skin del personaje. Revisa `"Costumes"` en [store/characters.json](/store/characters.json) |

### avatarInfoList

Para obtener datos básicos de personajes por la ID, ve a [store/characters.json](/store/characters.json). <br />
Para obtener información adicional, revisa los [Datos de Personajes](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json).

| Nombre | Descripción |
| :--- | :---------- |
| avatarID | ID del personaje |
| talentIdList | Lista de las IDs de las constelaciones <br /> No hay datos si la constelación es 0 |
| [propMap](#propmap) | Lista de propiedades de información del personaje |
| fightPropMap -> `{id: value}` | Mapa de las propiedades de combate del personaje. <br />Revisa la [Definición de las IDs](#fightprop)|
| skillDepotId | ID del conjunto de habilidades del personaje <br />[Datos de las Habilidades](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"id"`|
| inherentProudSkillList | Lista de IDs de la habilidad desbloqueada <br />[Datos de las Habilidades](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
| skillLevelMap -> `{skill_id: level}`| Mapa de los niveles de las habilidades <br /> [Datos de las Habilidades](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
| [equipList](#equiplist) | Lista del equipo: Arma y Artefactos |
| fetterInfo.expLevel | Nivel de amistad del personaje |

#### propMap

| Nombre | Descripción |
| :--- | :--------- |
| type | ID del tipo de propiedad, Revisa la [Definición de las IDs](#prop) |
| ival | Ignoralo |
| val | Valor de la propiedad |

#### equipList

| Nombre | Descripción |
| :--- | :--------- |
| itemId | ID del quipo <br /> [Datos de los Artefactos](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"` <br /> [Datos de las Armas](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/WeaponExcelConfigData.json) -> `"id"` |
| [weapon](#weapon) `[Solo Armas]` | Información base del arma |
| [reliquary](#reliquary) `[Solo Artefactos]` | Información base del artefacto |
| [flat](#flat) | Información detallada del equipo |

#### weapon

Para obtener información adicional sobre las armas, revisa los [Datos de las Armas](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/WeaponExcelConfigData.json)

| Nombre | Descripción |
| :--- | :---------- |
| level | Nivel del arma |
| promoteLevel | Nivel de ascensión del arma |
| affixMap | Nivel de refinamiento del arma `[0-4]` |


#### reliquary

Para obtener información adicional sobre los artefactos, revisa los [Datos de los Artefactos](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json)

| Nombre | Descripción |
| :--- | :---------- |
| 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) |

#### flat

| Nombre | Descripción |
| :--- | :---------- |
| nameTextHashMap | Hash para el nombre del equipo <br /> Revisa [Localizaciones](#localizaciones) |
| setNameTextHashMap `[Solo Artefactos]`| Hash para el nombre del conjunto del artefacto <br /> Revisa [Localizaciones](#localizaciones) |
| rankLevel | Nivel de rareza del equipo |
| [reliquaryMainstat](#reliquarymainstat-reliquarysubstats-weaponstats) `[Solo Artefactos]` | Stat principal del artefactos |
| [reliquarySubstats](#reliquarymainstat-reliquarysubstats-weaponstats) `[Solo Artefactos]` | Lista de los stats secundarios del artefacto |
| [weaponStats](#reliquarymainstat-reliquarysubstats-weaponstats) `[Solo Armas]`| Lista de Stats del arma: ATQ Base, Stat secundario |
| [itemType](#itemtype) | Tipo de equipo: Arma o Artefacto |
| icon | Nombre del icono del equipo <br /> [Uso de los nombres de iconos](#iconos-e-imágenes)|
| [equipType](#equiptype) `[Solo Artefactos]` | Tipo de artefacto |

#### reliquaryMainstat, reliquarySubstats, weaponStats

| Nombre | Descripción |
| :--- | :---------- |
| mainPropId / appendPropID | Nombre de la propiedad añadida del equipo. Revisa la [Definición de los Nombres](#appendprop)|
| propValue | Valor de la propiedad |

## Definiciones

### Prop

| Tipo | Descripción |
| :--: | :---------- |
| 1001 | XP |
| 1002 | Ascensión |
| 4001 | Nivel |

### FightProp

| Tipo | Descripción |
| :--: | :---------- |
| 1 | Vida Base |
| 4 | ATQ Base |
| 7 | DEF Base |
| 20 | Probabilidad de Crítico |
| 22 | Daño Crítico |
| 23 | Recarga de Energía |
| 26 | Bono de Curación |
| 27 | Bono de Curación recibido |
| 28 | Maestría Elemental |
| 29 | RES Física |
| 30 | Bono de Daño Físico |
| 40 | Bono de Daño Pyro |
| 41 | Bono de Daño Electro |
| 42 | Bono de Daño Hydro |
| 44 | Bono de Daño Anemo |
| 45 | Bono de Daño Geo |
| 46 | Bono de Daño Cryo |
| 50 | RES Pyro |
| 51 | RES Electro |
| 52 | RES Hydro |
| 53 | RES Dendro |
| 54 | RES Anemo |
| 55 | RES Geo |
| 56 | RES Cryo |
| 70 | Coste de Energía Pyro |
| 71 | Coste de Energía Electro |
| 72 | Coste de Energía Hydro |
| 73 | Coste de Energía Dendro |
| 74 | Coste de Energía Anemo |
| 75 | Coste de Energía Cryo |
| 76 | Coste de Energía Geo |
| 2000 | Vida Máx |
| 2001 | ATQ |
| 2002 | DEF |

### ItemType

| Nombre | Descripción |
| :--- | :---------- |
| ITEM_WEAPON | Arma |
| ITEM_RELIQUARY | Artefacto |

### EquipType

| Nombre | Descripción |
| :--- | :---------- |
| EQUIP_BRACER | Flor |
| EQUIP_NECKLACE | Pluma |
| EQUIP_SHOES | Reloj |
| EQUIP_RING | Copa |
| EQUIP_DRESS | Anillo |

### AppendProp

| Nombre | Descripción |
| :--- | :---------- |
| FIGHT_PROP_BASE_ATTACK `[Arma]` | ATQ Base |
| FIGHT_PROP_HP | Vida plana |
| FIGHT_PROP_ATTACK | ATQ plano |
| FIGHT_PROP_DEFENSE | DEF plana |
| FIGHT_PROP_HP_PERCENT | Vida% |
| FIGHT_PROP_ATTACK_PERCENT | ATQ% |
| FIGHT_PROP_DEFENSE_PERCENT | DEF% |
| FIGHT_PROP_CRITICAL | Probabilidad de Crítico |
| FIGHT_PROP_CRITICAL_HURT | Daño Crítico |
| FIGHT_PROP_CHARGE_EFFICIENCY | Recarga de Energía |
| FIGHT_PROP_HEAL_ADD | Bono de Curación |
| FIGHT_PROP_ELEMENT_MASTERY | Maestría Elemental |
| FIGHT_PROP_PHYSICAL_ADD_HURT | Bono de Daño Físico |
| FIGHT_PROP_FIRE_ADD_HURT | Bono de Daño Pyro |
| FIGHT_PROP_ELEC_ADD_HURT | Bono de Daño Electro |
| FIGHT_PROP_WATER_ADD_HURT | Bono de Daño Hydro |
| FIGHT_PROP_WIND_ADD_HURT | Bono de Daño Anemo |
| FIGHT_PROP_ICE_ADD_HURT | Bono de Daño Cryo |
| FIGHT_PROP_ROCK_ADD_HURT | Bono de Daño Geo |

## Iconos e Imágenes

Puedes obtener iconos de personajes, armas y artefactos en Enka, con la URL `https://enka.network/ui/[icon_name].png`.
Normalmente los nombres de los iconos empiezan por `"UI_"` o `"Skill_"` para los [Talentos de los Personajes](#talentos-de-los-personajes)
Por ejemplo https://enka.network/ui/UI_AvatarIcon_Side_Ambor.png.

### Armas y Artefactos

Ve a [flat](#flat) y busca por el `icon`.

### Personajes, Talentos y Constelaciones

Ve a [store/characters.json](/store/characters.json) y busca por algo relacionado con "UI_XXXXXX" o "Skill_XXXXXX" por la ID del personaje.

## Localizaciones

A lo mejor notas que `"NameTextMapHash"` en [store/characters.json](/store/characters.json), `"nameTextHashMap"` y `"setNameTextHashMap"` en [flat](#flat) podrían ser usados como llave para obtener la localización básica de los datos de personajes, armas y artefactos de [store/loc.json](/store/loc.json).
También puedes obtener la localización de los datos de [AppendProp](#appendprop) usando la propiedad como llave - `"FIGHT_PROP_HP"`, `"FIGHT_PROP_HEAL_ADD"` etc.

Para obtener información adicional sobre nombres, descripciones, etc, revisa los [Datos de los TextMap](https://github.com/Dimbreath/GenshinData/tree/master/TextMap), solo incluye idiomas soportados dentro del juego.


+ 236
- 0
api_ja.md View File

@@ -0,0 +1,236 @@
この日本語翻訳は不正確な場合があります。必要に応じて原文を参照してください
[api.md](/api.md)

# Enka.Network - API

## 目次

- [入門](#getting-started)
- [データ構造情報](#data-structure-info)
- [定義](#definitions)
- [アイコンと画像](#icons-and-images)
- [言語情報](#localizations)

## 入門

特定のURLに対してGETリクエストを行うことでJSONデータを取得できます-`https://enka.network/u/[UID]/__data.json`
例:https://enka.network/u/700378769/__data.json

## データ構造情報

| 名前 | 説明 |
| :--- | :---------- |
| [playerInfo](#playerinfo) | プロフィール情報 |
| [avatarInfoList](#avatarinfolist) | 公開されたキャラクター詳細のリスト |

### playerInfo

ID別の文字の基本データについては、[store/characters.json](/store/characters.json)にアクセスしてください。
追加情報については、[キャラクターデータ](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json)を確認してください。

| 名前 | 説明 |
| :--- | :--------- |
| nickname | プレイヤーのニックネーム |
| signature | ゲーム内ステータスメッセージ |
| worldLevel | 世界ランク |
| namecardId | 名刺ID |
| finishAchievementNum | 達成したアチーブメント数 |
| towerFloorIndex | 深境螺旋:層 |
| towerLevelIndex | 深境螺旋:間 |
| [showAvatarInfoList](#showavatarinfolist) | キャラクターIDとレベルのリスト |
| showNameCardIdList | 飾られた名刺のリスト |
| profilePicture.avatarId | プロフィールキャラクターのID |

#### showAvatarInfoList

| 名前 | 説明 |
| :--- | :--------- |
| avatarId | キャラクターID |
| level | キャラクターLv |
| costumeId | キャラクター衣装ID 詳細は[store/characters.json](/store/characters.json)内の`"Costumes"`に定義されています |

### avatarInfoList

ID別の文字の基本データについては、[store/characters.json](/store/characters.json)にアクセスしてください。
追加情報については、[キャラクターデータ](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json)を確認してください。

| 名前 | 説明 |
| :--- | :---------- |
| avatarID | キャラクターID |
| talentIdList | 命ノ星座IDのリスト<br>0重の場合はデータがありません |
| [propMap](#propmap) | 文字情報プロパティ一覧 |
| fightPropMap -> `{id: value}` | キャラクターの戦闘プロパティのマップ。<br>[IDの定義](#fightprop)を確認してください |
| skillDepotId | キャラクタースキルセットID <br />[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"id"`|
| inherentProudSkillList | 解放された固有天賦のIDリスト<br />[詳細情報](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
| skillLevelMap -> `{skill_id: level}`| スキルレベルのマップ <br /> [詳細情報](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
| [equipList](#equiplist) | 武器と聖遺物のリスト |
| fetterInfo.expLevel | 好感度Lv |

#### propMap

| 名前 | 説明 |
| :--- | :--------- |
| type | プロパティタイプのID 詳細は[IDの定義](#prop)を参照してください |
| ival | それを無視します(?) |
| val | プロパティの値 |

#### equipList

| 名前 | 説明 |
| :--- | :--------- |
| itemId | 識別ID <br /> [聖遺物情報](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"` <br />[武器情報](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/WeaponExcelConfigData.json) -> `"id"` |
| [weapon](#weapon) `[Weapon Only]` | 武器の基本情報 |
| [reliquary](#reliquary) `[Artifact Only]` | 聖遺物の基本情報 |
| [flat](#flat) | このアイテムの詳細情報 |

#### weapon

武器に関する追加情報については、[武器データ](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/WeaponExcelConfigData.json)を確認してください

| 名前 | 説明 |
| :--- | :---------- |
| level | 武器Lv |
| promoteLevel | 突破段階 |
| affixMap | 精錬ランク `[0-4]` |


#### reliquary

聖遺物に関する追加情報については、[聖遺物情報](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json)を確認してください

| 名前 | 説明 |
| :--- | :---------- |
| level | 聖遺物Lv `[1-21]` |
| mainPropId | 聖遺物メインステータスID(?)<br /> [MainProps Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) |

#### flat

| 名前 | 説明 |
| :--- | :---------- |
| nameTextHashMap | 表示名の識別番号 <br /> 参照:[言語情報](#localizations) |
| setNameTextHashMap `[Artifact Only]`| セット効果の識別番号<br /> 参照:[言語情報](#localizations)|
| rankLevel | レアリティ |
| [reliquaryMainstat](#reliquarymainstat-reliquarysubstats-weaponstats) `[Artifact Only]` | 聖遺物のメインステータス |
| [reliquarySubstats](#reliquarymainstat-reliquarysubstats-weaponstats) `[Artifact Only]` | 聖遺物のサブステータス |
| [weaponStats](#reliquarymainstat-reliquarysubstats-weaponstats) `[Weapon Only]`| 武器の基礎攻撃力とサブステータス |
| [itemType](#itemtype) | 種別(武器:`Weapon`,聖遺物:`Artifact`) |
| icon | アイテムアイコン名 <br /> [アイコン名の使用法](#icons-and-images)|
| [equipType](#equiptype) `[Artifact Only]` | 聖遺物種別 |

#### reliquaryMainstat, reliquarySubstats, weaponStats

| 名前 | 説明 |
| :--- | :---------- |
| mainPropId / appendPropID | プロパティ名。[名前の定義](#appendprop)を確認してください|
| propValue | プロパティ値 |

## 定義

### Prop

| ID | 説明 |
| :--: | :---------- |
| 1001 | XP |
| 1002 | Ascension |
| 4001 | Level |

### FightProp

| ID | 説明 |
| :--: | :---------- |
| 1 | 基礎HP |
| 4 | 基礎攻撃力 |
| 7 | 基礎防御力 |
| 20 | 会心率 |
| 22 | 会心ダメージ |
| 23 | 元素チャージ効率 |
| 26 | 与える治癒効果 |
| 27 | 受ける治癒効果 |
| 28 | 元素熟知 |
| 29 | 物理耐性 |
| 30 | 物理ダメージ |
| 40 | 炎元素ダメージ |
| 41 | 雷元素ダメージ |
| 42 | 水元素ダメージ |
| 44 | 風元素ダメージ |
| 45 | 岩元素ダメージ |
| 46 | 氷元素ダメージ |
| 50 | 炎元素耐性 |
| 51 | 雷元素耐性 |
| 52 | 水元素耐性 |
| 53 | Dendro RES |
| 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 | 最大HP |
| 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 | 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 | 岩元素ダメージ |

## アイコンと画像

`https://enka.network/ui/[icon_name].png`でキャラクター、武器、聖遺物のアイコンを得られます
通常、アイコン名は`"UI_"`または`"Skill_"`で始まる[characters talents](#キャラクターと天賦)を表します
例: https://enka.network/ui/UI_AvatarIcon_Side_Ambor.png

### 武器と聖遺物

[flat](#flat)の`icon`を参照

### キャラクターと天賦

[store/characters.json](/store/characters.json)から"UI_XXXXXX"または"Skill_XXXXXX"を探します

## Localizations

You may notice `"NameTextMapHash"` in [store/characters.json](/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](/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.

+ 239
- 0
api_th.md View File

@@ -0,0 +1,239 @@
การแปลภาษาไทยนี้อาจไม่ถูกต้อง 100% โปรดอ้างอิงจากข้อมูลต้นฉบับได้ที่
[api.md](/api.md)

# Enka.Network - API

## เนื้อหา

- [เริ่มต้นการใช้งาน](#เริ่มต้นการใช้งาน)
- [โครงสร้างข้อมูล](#โครงสร้างข้อมูล)
- [คำนิยาม](#คำนิยาม)
- [ไอคอน และรูปภาพ](#ไอคอน-และรูปภาพ)
- [ภาษา](#ภาษา)

## เริ่มต้นการใช้งาน

คุณสามารถดึงข้อมูล JSON จากลิ้งก์ - `https://enka.network/u/[UID]/__data.json` <br />
ยกตัวอย่างเช่น https://enka.network/u/700378769/__data.json

## โครงสร้างข้อมูล

| ชื่อ | คำอธิบาย |
| :--- | :---------- |
| [playerInfo](#playerinfo) | ข้อมูลโปรไฟล์ |
| [avatarInfoList](#avatarinfolist) | ลิสข้อมูลรายละเอียดของหน้าตู้ตัวละคร |

### playerInfo

สำหรับข้อมูลเบื้องต้นของตัวละครโดยไอดีนั้น, ไปที่ [store/characters.json](/store/characters.json). <br />
สำหรับข้อมูลเพิ่มเติม ตรวจสอบได้ที่ [Characters Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json).


| ชื่อ | คำอธิบาย |
| :--- | :--------- |
| nickname | ชื่อเล่นของผู้เล่น |
| signature | ลายเซ็นโปรไฟล์ |
| worldLevel | ระดับโลกของผู้เล่น |
| namecardId | เลขนามบัตร |
| finishAchievementNum | จำนวนความสำเร็จที่ได้รับ |
| towerFloorIndex | ชั้น Abyss |
| towerLevelIndex | ห้อง Abyss |
| [showAvatarInfoList](#showavatarinfolist) | ลิสไอดีตัวละครและเลเวล |
| showNameCardIdList | ลิสนามบัตร |
| profilePicture.avatarID | ไอดีตัวละครของรูปโปรไฟล์ |

#### showAvatarInfoList

| ชื่อ | คำอธิบาย |
| :--- | :--------- |
| avatarId |ไอดีตัวละคร |
| level | เลเวลตัวละคร |
| costumeId | ไอดีชุดคอสตูมของตัวละคร ตรวจสอบได้ที่ `"Costumes"` ใน [store/characters.json](/store/characters.json) |

### avatarInfoList

สำหรับข้อมูลเบื้องต้นของตัวละครโดยไอดีนั้น, ไปที่ [store/characters.json](/store/characters.json). <br />
สำหรับข้อมูลเพิ่มเติม ตรวจสอบได้ที่ [Characters Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json).

| ชื่อ | คำอธิบาย |
| :--- | :---------- |
| avatarID | ไอดีตัวละคร |
| talentIdList | ลำดับกลุ่มดาว <br /> หากเป็น 0 ก็คือไม่มีข้อมูล |
| [propMap](#propmap) | คุณสมบัติของตัวละคร |
| fightPropMap -> `{id: value}` | ข้อมูลตัวละคร <br />โปรดตรวจสอบได้ที่ [คำนิยามสำหรับไอดี](#fightprop)|
| skillDepotId | เซ็ทไอดีสกิลตัวละคร <br />[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"id"`|
| inherentProudSkillList | ระดับการปลดล็อกพรรสวรรค์ <br />[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
| skillLevelMap -> `{skill_id: level}`| เลเวลพรรสวรรค์ <br /> [Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
| [equipList](#equiplist) | รายชื่ออาวุธและอาติแฟส |
| fetterInfo.expLevel | เลเวลความประทับใจของตัวละคร |

#### propMap

| ชื่อ | คำอธิบาย |
| :--- | :--------- |
| type | ไอดีชนิดคุณสมบัติ ตรวจสอบได้ที่ [Definitions for IDs](#prop) |
| ival | ไม่ต้องสนใจ |
| val | ค่าคุณสมบัติ |

#### equipList

| ชื่อ | คำอธิบาย |
| :--- | :--------- |
| itemId | ไอดีไอเทม <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 | Stats อาติแฟสหลัก <br /> [MainProps Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) |

#### flat

| ชื่อ | คำอธิบาย |
| :--- | :---------- |
| nameTextHashMap | ไอดีชื่อไอเทม <br /> ตรวจสอบได้ที่ [ภาษา](#ภาษา) |
| setNameTextHashMap `[Artifact Only]`| ไอดีชื่อของอาติแฟส <br /> ตรวจสอบได้ที่ [ภาษา](#ภาษา)|
| rankLevel | ระดับความหายากของไอเทม |
| [reliquaryMainstat](#reliquarymainstat-reliquarysubstats-weaponstats) `[Artifact Only]` | Stats อาติแฟสหลัก |
| [reliquarySubstats](#reliquarymainstat-reliquarysubstats-weaponstats) `[Artifact Only]` | ลิส Stats อาติแฟสรอง |
| [weaponStats](#reliquarymainstat-reliquarysubstats-weaponstats) `[Weapon Only]`| ลิส Stats อาวุธ |
| [itemType](#itemtype) | ชนิดไอเทม (อาวุธ หรือ อาติแฟส) |
| icon | ไอคอนไอเทม <br /> [ไอคอน และรูปภาพ](#ไอคอน-และรูปภาพ)|
| [equipType](#equiptype) `[Artifact Only]` | ชนิดอาติแฟส |

#### reliquaryMainstat, reliquarySubstats, weaponStats

| ชื่อ | คำอธิบาย |
| :--- | :---------- |
| mainPropId / appendPropID | ชื่อคุณสมบัติของไอเทม ตรวจสอบใน [คำนิยามสำหรับชื่อ](#appendprop)|
| propValue | ค่าคุณสมบัติ |

## คำนิยาม

### Prop

| ชนิด | คำอธิบาย |
| :--: | :---------- |
| 1001 | XP |
| 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 ได้โดยใช้ลิ้งก์ `https://enka.network/ui/[icon_name].png`
โดยปกติแล้วชื่อไอคอนจะขึ้นต้นด้วย `"UI_"` หรือ `"Skill_"` จาก [พรรสวรรค์ตัวละคร](#ตัวละคร,-พรรสวรรค์-และกลุ่มดาว)
ยกตัวอย่างเช่น https://enka.network/ui/UI_AvatarIcon_Side_Ambor.png

### อาวุธ และอาติแฟส

ไปที่ [flat](#flat) และมองหาคำว่า `icon`.

### ตัวละคร, พรรสวรรค์ และกลุ่มดาว

ไปที่ [store/characters.json](/store/characters.json) และมองหาข้อมูลสิ่งที่เกี่ยวข้องอย่าง "UI_XXXXXX" หรือ "Skill_XXXXXX" จากไอดีตัวละคร

## ภาษา

คุณอางสังเกตุเห็นว่า `"NameTextMapHash"` ในข้อมูล [store/characters.json](/store/characters.json), `"nameTextHashMap"` และ `"setNameTextHashMap"` จาก [flat](#flat) นั้นที่จะสามารถใช้เป็นคีย์สำหรับในการหาข้อมูลภาษาจากตัวละคร, อาวุธ และ อาติแฟสจาก [store/loc.json](/store/loc.json).
นอกจากนี้คุณยังสามารถดึงข้อมูลภาษาจาก [AppendProp](#appendprop) โดยใช้ชื่อคีย์คุณสมบัติอย่าง - `"FIGHT_PROP_HP"`, `"FIGHT_PROP_HEAL_ADD"` และอิ่น ๆ


สำหรับข้อมูลเพิ่มเติมเกี่ยวกับชื่อ, คำอธิบาย และ อื่น ๆ นั้น ตรวจสอบได้ที่ [TextMap Data](https://github.com/Dimbreath/GenshinData/tree/master/TextMap) เฉพาะภาษาที่เกมส์รองรับเท่านั้น


Loading…
Cancel
Save