Merge pull request #74 from Musenmy/Musenmy-jajp-upgate

update ja-JP

Author: Algoinde

api_ja.md

@@ -1,11 +1,11 @@
-この日本語翻訳は不正確な場合があります。必要に応じて原文を参照してください
-[api.md](/api.md)
+この日本語ドキュメントは翻訳されたものであり、不正確な場合があります。必要に応じて[英語版の原文](/api.md)を参照してください
 
 # Enka.Network - API
 
 ## 目次
 
 - [入門](#入門)
+- [API一覧](#api一覧)
 - [データ構造情報](#データ構造情報)
 - [定義](#定義)
 - [アイコンと画像](#アイコンと画像)
@@ -19,26 +19,26 @@
 最大の課題は、データマイニングされたゲームデータをナビゲートし、適切な方法で返されたデータを使用することです。
 
 様々な言語のラッパーについては、[Wrappers](#wrappers)を参照してください。
-## 利用する前に
 
+## 利用する前に
 APIを使用する際のいくつかのルールです。
 
 1. UIDを列挙したり、データベースを埋めるために大量のリクエストを実行しようとしないでください。
 UIDは何億もあり、このAPIでこれを実行することはできません。後日、バッチデータを提供することがあります。
 
 2. リクエストにはカスタムした`User-Agent` ヘッダを設定してください。
-そうすることで、リクエストをより良く追跡し、必要に応じてあなたを助けることができます。
+そうすることで、リクエストの追跡が簡単になり、必要に応じてあなたを助けることもできます。
 
 3. UIDのエンドポイントには動的な速度制限があります。
 あまりに速く再リクエストすると、応答時間が遅くなり、最終的にはステータスコード429が返されます。
 この場合、速度を落とすか、私に連絡してレートリミットを増やすことが可能かどうかを確認する必要があります。
 殆どの場合、これは必要ではなく、最適化されていないコードが原因です。
 
 4. 全てのUIDリクエストには`ttl`というフィールドを返します。
-このフィールドは「リクエストされたUIDに対して次の更新(Showcase)が行われるまでの秒数」です。
-このフィールドがなくなるまで、エンドポイントはキャッシュされたデータを返しますが、繰り返しヒットするとレートリミットを消費してしまいます。
+このフィールドは「リクエストされたUIDに対して次のデータ更新が行われるまでの秒数」です。
+値が0になるまでエンドポイントはキャッシュされたデータを返しますが、その間であってもリクエストするとレートリミットを消費してしまいます。
 リクエスト時に`ttl`のタイムアウトを設けてデータをキャッシュするか、`ttl`が切れるまでそのUIDへのリクエストを行わないようにすることを試してみてください。
-これにはRedisをお勧めします。
+この処理にはRedisなどを用いることをお勧めします。
 
 もしデータの扱いに困ったら、[Discordサーバー](https://discord.gg/PcSZr5sbn3)でヘルプを受けられます。
 
@@ -50,17 +50,17 @@ UIDは何億もあり、このAPIでこれを実行することはできませ
 
 レスポンスには `playerInfo` と `avatarInfoList` が含まれます。
 `playerInfo`はゲームアカウントに関する基本的なデータです。
-もし `avatarInfoList` が見つからない場合は、このゲームアカウントはプロフィールが非公開に設定されているか、キャラクターが設定されていないことを意味します。
+もし `avatarInfoList` が見つからない場合は、当該UIDのアカウントはプロフィールが非公開にされているか、キャラクターが設定されていないことを意味します。
 
-#### プレイヤー情報をのみを取得
+#### プレイヤー情報のみを取得
 
 > https://enka.network/api/uid/618285856/?info
 
 リクエストに `?info` を付けることで、`playerInfo` のみをリクエストすることができます。
 もし `playerInfo` だけが必要であれば、このエンドポイントを使用してください。
 全てのデータを取得するよりもずっと速く取得する事が出来ます。
 
-さらに、以下の場合にのみ、両方のレスポンスに `owner` オブジェクトが含まれます。
+さらに、以下の条件を満たす場合、両方のレスポンスに `owner` オブジェクトが含まれます。
 
 1. ユーザがこのサイトにアカウントを持っている。
 2. ユーザーが自分のUIDをプロファイルに追加した。
@@ -74,20 +74,20 @@ UIDは何億もあり、このAPIでこれを実行することはできませ
 アプリ内でこれらが適切に処理されるようにしてください。
 
 ```
-400 = UIDのフォーマットが合っていない
-404 = 対象のプレイヤーが存在しない (これはmihoyoサーバーからのレスポンスです)
-424 = ゲームメンテナンス(更新等) / ゲームアップデート後にシステムが破壊的な影響を受けた
-429 = レートリミット(EnkaNetWorkかmihoyoサーバーのどちらか)
-500 = EnkaNetWorkサーバーのエラー
-503 = EnkaNetWorkサーバーの一時停止中
+400 = UIDの形式不正 (入力された値が範囲外であるなど)
+404 = そのUIDを持つプレイヤーが存在しない (これはmiHoYoサーバーからのレスポンスです)
+424 = ゲームメンテナンス (更新等) / ゲームアップデート後にシステムが大幅に変更されて更新が必要
+429 = レートリミット (Enka.NetWorkかmiHoYoサーバーのどちらか)
+500 = Enka.NetWorkサーバーのエラー
+503 = Enka.NetWorkサーバーの一時停止中
 ```
 
 ### プロファイルエンドポイント
 
 ウェブサイト上でアカウント（プロファイル）を作成し、そのアカウントに複数のゲームアカウントを設定することが可能です。
 ユーザーは、認証ページに記載された認証コードによって、そのアカウントが自分のものであることを証明する必要があります。
 
-ユーザーは、好きな名称でビルドを「スナップショット」することができ、「セーブドビルド」と呼ばれています。
+ユーザーは、好きな名称でビルドを「スナップショット」することができ、「保存されたビルド」と呼ばれています。
 
 > https://enka.network/api/profile/Algoinde/
 
@@ -111,7 +111,7 @@ UIDは何億もあり、このAPIでこれを実行することはできませ
 ビルドに `live:　true` フィールドがある場合、それは「保存」されたビルドではなく、単に「更新」をクリックした時に取得されたものであることを意味します。
 更新すると、古い`live`ビルドはすべて削除され、新しいビルドが作成されます。この更新をいつ行うかは、ユーザーだけが決めることができます。
 
-[UID エンド ポイント](#UIDエンドポイント)で説明したように、UIDリクエストを行うと、`owner`オブジェクトを取得することができます。
+[UIDエンドポイント](#uidエンドポイント)で説明したように、UIDリクエストを行うと、`owner`オブジェクトを取得することができます。
 このオブジェクトのフィールドを使用して、URLを作成することができます。
 
 `https://enka.network/api/profile/{owner.username}/hoyos/{owner.hash}/builds/`
@@ -125,71 +125,71 @@ UIDは何億もあり、このAPIでこれを実行することはできませ
 
 ### playerInfo
 
-ID別の文字の基本データについては、[store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)にアクセスしてください。
-追加情報については、[キャラクターデータ](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/AvatarExcelConfigData.json)を確認してください。
+キャラクターのID別の基本データについては、[store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)を参照。
+より詳細な情報については、[キャラクターデータ](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/AvatarExcelConfigData.json)を参照。
 
 | 名前 | 説明 |
 | :--- | :--------- |
 | nickname | プレイヤーのニックネーム |
 | signature | ゲーム内ステータスメッセージ |
 | worldLevel | 世界ランク |
-| namecardId | 名刺ID |
+| namecardId | メインで設定された名刺ID |
 | finishAchievementNum | 達成したアチーブメント数 |
-| towerFloorIndex | 深境螺旋：層 |
-| towerLevelIndex | 深境螺旋：間 |
-| [showAvatarInfoList](#showavatarinfolist) | キャラクターIDとレベルのリスト |
-| showNameCardIdList | 飾られた名刺のリスト |
-| profilePicture.avatarId | プロフィールキャラクターのID |
+| towerFloorIndex | クリアした深境螺旋の層数 |
+| towerLevelIndex | クリアした深境螺旋の間数 |
+| [showAvatarInfoList](#showavatarinfolist) | 展示されたキャラクターIDとレべルのリスト |
+| showNameCardIdList | 展示された名刺のリスト |
+| profilePicture.avatarId | プロフィール画像のID |
 
 #### showAvatarInfoList
 
 | 名前 | 説明 |
 | :--- | :--------- |
 | avatarId | キャラクターID |
-| level | キャラクターLv |
-| costumeId | キャラクター衣装ID 詳細は[store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)内の`"Costumes"`に定義されています  |
+| level | キャラクターレべル |
+| costumeId | キャラクター衣装ID<br>詳細は[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)にアクセスしてください。
-追加情報については、[キャラクターデータ](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/AvatarExcelConfigData.json)を確認してください。
+キャラクターのID別の基本データについては、[store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)を参照。
+追加情報については、[キャラクターデータ](https://gitlab.com/Dimbreath/AnimeGameData/-/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://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) ->     `"id"`             |
-| inherentProudSkillList | 解放された固有天賦のIDリスト<br />[詳細情報](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
+| talentIdList | 解放済みの命ノ星座IDのリスト<br>C0の場合はこの項目はundefined                                                                                                                                            |
+| [propMap](#propmap) | キャラクター情報のプロパティ                                                                                                                                                              |
+| fightPropMap -> `{id: value}` | キャラクターの戦闘ステータスのMap。<br>[FightPropの定義](#fightprop)を確認してください                                                                                                                      |
+| skillDepotId | キャラクタースキルID <br />[Skills Data](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) ->     `"id"`             |
+| inherentProudSkillList | 解放された天賦のIDリスト<br />[詳細情報](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"` |
 | skillLevelMap -> `{skill_id: level}`| スキルレベルのマップ <br /> [詳細情報](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/AvatarSkillDepotExcelConfigData.json) -> `"inherentProudSkillOpens"`    |
-| [equipList](#equiplist) | 武器と聖遺物のリスト                                                                                                                                                               |
-| fetterInfo.expLevel  | 好感度Lv                                                                                                                                                                    |
+| [equipList](#equiplist) | 装備済の武器と聖遺物のリスト                                                                                                                                                               |
+| fetterInfo.expLevel  | 好感度レべル                                                                                                                                                                    |
 
 #### propMap
 
 | 名前 | 説明 |
 | :--- | :--------- |
 | type | プロパティタイプのID 詳細は[IDの定義](#prop)を参照してください |
-| ival | 無効な値(これは無視してください) |
+| ival | 無効な値 (これは使用しないでください) |
 | val  | プロパティの値 |
 
 #### equipList
 
 | 名前 | 説明 |
 | :--- | :--------- |
-| itemId | 識別ID <br /> [聖遺物情報](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"` <br />[武器情報](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/WeaponExcelConfigData.json) -> `"id"` |
+| itemId | 装備品のID <br /> [聖遺物情報](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/ReliquaryExcelConfigData.json) -> `"id"` <br />[武器情報](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/WeaponExcelConfigData.json) -> `"id"` |
 | [weapon](#weapon) `[Weapon Only]` | 武器の基本情報  |
 | [reliquary](#reliquary) `[Artifact Only]` | 聖遺物の基本情報  |
-| [flat](#flat) | このアイテムの詳細情報 |
+| [flat](#flat) | 各装備品の詳細情報 |
 
 #### weapon
 
 武器に関する追加情報については、[武器データ](https://gitlab.com/Dimbreath/AnimeGameData/-/blob/master/ExcelBinOutput/WeaponExcelConfigData.json)を確認してください
 
 | 名前 | 説明 |
 | :--- | :---------- |
-| level | 武器Lv |
+| level | 武器レべル |
 | promoteLevel | 突破段階 |
 | affixMap | 精錬ランク `[0-4]` |
 
@@ -373,8 +373,8 @@ ID別の文字の基本データについては、[store/characters.json](https:
 [store/characters.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/characters.json)から"UI_XXXXXX"または"Skill_XXXXXX"を探します
 
 ## 言語情報
-[store/loc.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/loc.json)で各言語の翻訳文字列を得る事が出来ます。
-この時使用されるキー文字列は
+[store/loc.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/loc.json)でIDから各言語に対応した文字列を得る事が出来ます。
+この時に使用されるキーとなるIDは
 * [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"`
@@ -394,4 +394,4 @@ Python - https://github.com/mrwan200/enkanetwork.py - [mrwan200](https://github.
 
 Python - https://github.com/seriaati/enka-py - [seriaati](https://github.com/seriaati)
 
-Java - https://github.com/kazuryyx/EnkaNetworkAPI - [kazury](https://github.com/kazuryyx)
+Java - https://github.com/kazuryyx/EnkaNetworkAPI - [kazury](https://github.com/kazuryyx)