| @@ -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 | ID ชุดคอสตูมของตัวละคร ตรวจสอบได้ที่ `"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 />โปรดตรวจสอบได้ที่ [Definitions for IDs](#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) เฉพาะภาษาที่เกมส์รองรับเท่านั้น | |||||