From 3567e8212a23c9f8e8fefb17407c63e6e8383eaf Mon Sep 17 00:00:00 2001 From: eratou <56436885+eratou@users.noreply.github.com> Date: Mon, 11 Jul 2022 06:53:51 +0900 Subject: [PATCH 01/10] Create api_ja.md --- api_ja.md | 238 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 238 insertions(+) create mode 100644 api_ja.md diff --git a/api_ja.md b/api_ja.md new file mode 100644 index 0000000..9cf40df --- /dev/null +++ b/api_ja.md @@ -0,0 +1,238 @@ +この日本語翻訳は不正確な場合があります。必要に応じて原文を参照してください +[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のリスト
0重の場合はデータがありません | +| [propMap](#propmap) | 文字情報プロパティ一覧 | +| fightPropMap -> `{id: value}` | キャラクターの戦闘プロパティのマップ。
[IDの定義](#fightprop)を確認してください | +| skillDepotId | キャラクタースキルセットID
[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"id"`| +| inherentProudSkillList | 解放された固有天賦のIDリスト
[詳細情報](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` | +| skillLevelMap -> `{skill_id: level}`| スキルレベルのマップ
[詳細情報](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
+[聖遺物情報](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"`
+[武器情報](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(?)
[MainProps Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) | + +#### flat + +| 名前 | 説明 | +| :--- | :---------- | +| nameTextHashMap | 表示名の識別番号
参照:[言語情報](#localizations) | +| setNameTextHashMap `[Artifact Only]`| セット効果の識別番号
参照:[言語情報](#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 | アイテムアイコン名
[アイコン名の使用法](#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. From 54949cfd9d4db0a50d263aea50fec0c65b8c5099 Mon Sep 17 00:00:00 2001 From: eratou <56436885+eratou@users.noreply.github.com> Date: Mon, 11 Jul 2022 06:56:54 +0900 Subject: [PATCH 02/10] Fix api_ja.md --- api_ja.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/api_ja.md b/api_ja.md index 9cf40df..62e1f41 100644 --- a/api_ja.md +++ b/api_ja.md @@ -78,9 +78,7 @@ ID別の文字の基本データについては、[store/characters.json](/store | 名前 | 説明 | | :--- | :--------- | -| itemId | 識別ID
-[聖遺物情報](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"`
-[武器情報](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/WeaponExcelConfigData.json) -> `"id"` | +| itemId | 識別ID
[聖遺物情報](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"`
[武器情報](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/WeaponExcelConfigData.json) -> `"id"` | | [weapon](#weapon) `[Weapon Only]` | 武器の基本情報 | | [reliquary](#reliquary) `[Artifact Only]` | 聖遺物の基本情報 | | [flat](#flat) | このアイテムの詳細情報 | From c2014b77401af49a4b918fb556646b00b9d399f7 Mon Sep 17 00:00:00 2001 From: Algoinde Date: Mon, 11 Jul 2022 12:27:37 +0500 Subject: [PATCH 03/10] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 078acd8..80c8fe6 100644 --- a/README.md +++ b/README.md @@ -4,4 +4,5 @@ > Fetch data from your Character Showcase and display a build card, instantly. -[API docs](/api.md) \ No newline at end of file +[API docs](/api.md) +[APIドキュメント](/api_ja.md) From b69f630bff18b2bfd06424bfe370a2aeae6f32f9 Mon Sep 17 00:00:00 2001 From: Algoinde Date: Mon, 11 Jul 2022 12:27:50 +0500 Subject: [PATCH 04/10] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 80c8fe6..0e5486c 100644 --- a/README.md +++ b/README.md @@ -4,5 +4,5 @@ > Fetch data from your Character Showcase and display a build card, instantly. -[API docs](/api.md) -[APIドキュメント](/api_ja.md) +* [API docs](/api.md) +* [APIドキュメント](/api_ja.md) From f0b23eff4e795e4d08ef3373fd526c58aee64f33 Mon Sep 17 00:00:00 2001 From: M-307 Date: Tue, 12 Jul 2022 01:48:40 +0700 Subject: [PATCH 05/10] Add thai languege docs. --- api_th.md | 239 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 239 insertions(+) create mode 100644 api_th.md diff --git a/api_th.md b/api_th.md new file mode 100644 index 0000000..cbfce5c --- /dev/null +++ b/api_th.md @@ -0,0 +1,239 @@ +การแปลภาษาไทยนี้อาจไม่ถูกต้อง 100% โปรดอ้างอิงจากข้อมูลต้นฉบับได้ที่ +[api.md](/api.md) + +# Enka.Network - API + +## เนื้อหา + +- [เริ่มต้นการใช้งาน](#เริ่มต้นการใช้งาน) +- [โครงสร้างข้อมูล](#โครงสร้างข้อมูล) +- [คำนิยาม](#คำนิยาม) +- [ไอคอน และรูปภาพ](#ไอคอน-และรูปภาพ) +- [ภาษา](#ภาษา) + +## เริ่มต้นการใช้งาน + +คุณสามารถดึงข้อมูล JSON จากลิ้งก์ - `https://enka.network/u/[UID]/__data.json`
+ยกตัวอย่างเช่น https://enka.network/u/700378769/__data.json + +## โครงสร้างข้อมูล + +| ชื่อ | คำอธิบาย | +| :--- | :---------- | +| [playerInfo](#playerinfo) | ข้อมูลโปรไฟล์ | +| [avatarInfoList](#avatarinfolist) | ลิสข้อมูลรายละเอียดของหน้าตู้ตัวละคร | + +### playerInfo + +สำหรับข้อมูลเบื้องต้นของตัวละครโดยไอดีนั้น, ไปที่ [store/characters.json](/store/characters.json).
+สำหรับข้อมูลเพิ่มเติม ตรวจสอบได้ที่ [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 | ID ชุดคอสตูมของตัวละคร ตรวจสอบได้ที่ `"Costumes"` ใน [store/characters.json](/store/characters.json) | + +### avatarInfoList + +สำหรับข้อมูลเบื้องต้นของตัวละครโดยไอดีนั้น, ไปที่ [store/characters.json](/store/characters.json).
+สำหรับข้อมูลเพิ่มเติม ตรวจสอบได้ที่ [Characters Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarExcelConfigData.json). + +| ชื่อ | คำอธิบาย | +| :--- | :---------- | +| avatarID | ไอดีตัวละคร | +| talentIdList | ลำดับกลุ่มดาว
หากเป็น 0 ก็คือไม่มีข้อมูล | +| [propMap](#propmap) | คุณสมบัติของตัวละคร | +| fightPropMap -> `{id: value}` | ข้อมูลตัวละคร
โปรดตรวจสอบได้ที่ [Definitions for IDs](#fightprop)| +| skillDepotId | เซ็ทไอดีสกิลตัวละคร
[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"id"`| +| inherentProudSkillList | ระดับการปลดล็อกพรรสวรรค์
[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` | +| skillLevelMap -> `{skill_id: level}`| เลเวลพรรสวรรค์
[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 | ไอดีไอเทม
[Artifacts Data](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"`
[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 อาติแฟสหลัก
[MainProps Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/ReliquaryMainPropExcelConfigData.json) | + +#### flat + +| ชื่อ | คำอธิบาย | +| :--- | :---------- | +| nameTextHashMap | ไอดีชื่อไอเทม
ตรวจสอบได้ที่ [ภาษา](#ภาษา) | +| setNameTextHashMap `[Artifact Only]`| ไอดีชื่อของอาติแฟส
ตรวจสอบได้ที่ [ภาษา](#ภาษา)| +| 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 | ไอคอนไอเทม
[ไอคอน และรูปภาพ](#ไอคอน-และรูปภาพ)| +| [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) เฉพาะภาษาที่เกมส์รองรับเท่านั้น + From b5664a0c50e578c1c720fe144c586a4638e1a4b8 Mon Sep 17 00:00:00 2001 From: M-307 Date: Tue, 12 Jul 2022 01:51:54 +0700 Subject: [PATCH 06/10] Fix typo --- api_th.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api_th.md b/api_th.md index cbfce5c..6e4678d 100644 --- a/api_th.md +++ b/api_th.md @@ -48,7 +48,7 @@ | :--- | :--------- | | avatarId |ไอดีตัวละคร | | level | เลเวลตัวละคร | -| costumeId | ID ชุดคอสตูมของตัวละคร ตรวจสอบได้ที่ `"Costumes"` ใน [store/characters.json](/store/characters.json) | +| costumeId | ไอดีชุดคอสตูมของตัวละคร ตรวจสอบได้ที่ `"Costumes"` ใน [store/characters.json](/store/characters.json) | ### avatarInfoList @@ -60,7 +60,7 @@ | avatarID | ไอดีตัวละคร | | talentIdList | ลำดับกลุ่มดาว
หากเป็น 0 ก็คือไม่มีข้อมูล | | [propMap](#propmap) | คุณสมบัติของตัวละคร | -| fightPropMap -> `{id: value}` | ข้อมูลตัวละคร
โปรดตรวจสอบได้ที่ [Definitions for IDs](#fightprop)| +| fightPropMap -> `{id: value}` | ข้อมูลตัวละคร
โปรดตรวจสอบได้ที่ [คำนิยามสำหรับไอดี](#fightprop)| | skillDepotId | เซ็ทไอดีสกิลตัวละคร
[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"id"`| | inherentProudSkillList | ระดับการปลดล็อกพรรสวรรค์
[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` | | skillLevelMap -> `{skill_id: level}`| เลเวลพรรสวรรค์
[Skills Data](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` | From f26868330d2fc6ccdfbf7881b46f2a741bded4d2 Mon Sep 17 00:00:00 2001 From: Jelosus2 <75176441+Jelosus2@users.noreply.github.com> Date: Mon, 11 Jul 2022 21:03:23 +0200 Subject: [PATCH 07/10] Create api_es.md --- api_es.md | 237 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 237 insertions(+) create mode 100644 api_es.md diff --git a/api_es.md b/api_es.md new file mode 100644 index 0000000..e62abfa --- /dev/null +++ b/api_es.md @@ -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`
+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).
+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).
+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
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.
Revisa la [Definición de las IDs](#fightprop)| +| skillDepotId | ID del conjunto de habilidades del personaje
[Datos de las Habilidades](https://github.com/Dimbreath/GenshinData/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"id"`| +| inherentProudSkillList | Lista de IDs de la habilidad desbloqueada
[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
[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
[Datos de los Artefactos](https://raw.githubusercontent.com/Dimbreath/GenshinData/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"`
[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
[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
Revisa [Localizaciones](#localizaciones) | +| setNameTextHashMap `[Solo Artefactos]`| Hash para el nombre del conjunto del artefacto
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
[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. + From e7a9088eb49949fb2ea7f296432952c7f2c34643 Mon Sep 17 00:00:00 2001 From: Algoinde Date: Tue, 12 Jul 2022 03:15:38 +0500 Subject: [PATCH 08/10] Update api.md --- api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api.md b/api.md index 33583c0..6a5eada 100644 --- a/api.md +++ b/api.md @@ -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 From dfc9b4a8d10452d5a95c59374b1dc41fd2351fd7 Mon Sep 17 00:00:00 2001 From: Algoinde Date: Tue, 12 Jul 2022 03:16:09 +0500 Subject: [PATCH 09/10] Update api_ja.md --- api_ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api_ja.md b/api_ja.md index 62e1f41..bc5ea72 100644 --- a/api_ja.md +++ b/api_ja.md @@ -39,7 +39,7 @@ ID別の文字の基本データについては、[store/characters.json](/store | towerLevelIndex | 深境螺旋:間 | | [showAvatarInfoList](#showavatarinfolist) | キャラクターIDとレベルのリスト | | showNameCardIdList | 飾られた名刺のリスト | -| profilePicture.avatarID | プロフィールキャラクターのID | +| profilePicture.avatarId | プロフィールキャラクターのID | #### showAvatarInfoList From c3a909f20bbc38fdf49958942b9b3390cc8425a5 Mon Sep 17 00:00:00 2001 From: Algoinde Date: Tue, 12 Jul 2022 03:19:19 +0500 Subject: [PATCH 10/10] Update README.md --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0e5486c..218e5c8 100644 --- a/README.md +++ b/README.md @@ -5,4 +5,6 @@ * [API docs](/api.md) -* [APIドキュメント](/api_ja.md) +* [JA | APIドキュメント](/api_ja.md) +* [ES | Documentación de la API](/api_es.md) +* [TH | เอกสาร API](/api_th.md)