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. +