From 87deb89b82393aad79643463eec6a3f870001131 Mon Sep 17 00:00:00 2001 From: aclist <92275929+aclist@users.noreply.github.com> Date: Sat, 6 Jul 2024 20:44:09 +0900 Subject: [PATCH 1/2] docs: fix url --- docs/dzgui_dark.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dzgui_dark.adoc b/docs/dzgui_dark.adoc index 740b6ad..d79e46c 100644 --- a/docs/dzgui_dark.adoc +++ b/docs/dzgui_dark.adoc @@ -7,7 +7,7 @@ DayZ server browser and mod manager for Linux | Last updated: {d} Click https://aclist.github.io/dzgui/dzgui.html[here] for light mode -Looking for the DZGUI Knowledge Base? Click https://aclist.github.io/dzgui/kb.html[here] +Looking for the DZGUI Knowledge Base? Click https://aclist.github.io/dzgui/kb_dark.html[here] == What this is A GUI version of https://github.com/aclist/dztui[DZTUI] for Linux. From 5a45e20cbe93b355ed83ce62adadb0951ba0972c Mon Sep 17 00:00:00 2001 From: aclist <92275929+aclist@users.noreply.github.com> Date: Sun, 14 Jul 2024 22:24:48 +0900 Subject: [PATCH 2/2] docs: update API info --- docs/dzgui.adoc | 7 +++++-- docs/dzgui_dark.adoc | 7 +++++-- docs/kb_sections/dzg007.adoc | 14 +++++++------- 3 files changed, 17 insertions(+), 11 deletions(-) diff --git a/docs/dzgui.adoc b/docs/dzgui.adoc index 134adce..e18dcff 100644 --- a/docs/dzgui.adoc +++ b/docs/dzgui.adoc @@ -102,11 +102,14 @@ Enable a Proton version ≥ `6.8` (or use Proton Experimental) in the `Compatibi === API key & server IDs -==== Steam API key (required) -1. Register for a https://steamcommunity.com/dev/apikey[Steam API key] (free) using your Steam account. You will be asked for a unique URL for your app when registering. +==== Steam Web API key (required) +1. Register for a https://steamcommunity.com/dev/apikey[Steam Web API key] (free) using your Steam account. You will be asked for a unique URL for your app when registering. 2. Since this key is for a personal use application and does not actually call back anywhere, set a generic local identifier here like "127.0.0.1" or some other name that is meaningful to you. 3. Once configured, you can insert this key in the app when launching it for the first time. +[NOTE] +If you are confused about this requirement, please refer to DZGUI Knowledge Base article https://aclist.github.io/dzgui/kb.html#DZG-007[DZG-007] for additional information. + ==== BattleMetrics API key (optional) This key is optional. Using this key in conjunction with the above allows you to also connect to and query servers by numerical ID instead of by IP. See < Add server by ID, Add server by ID>>. diff --git a/docs/dzgui_dark.adoc b/docs/dzgui_dark.adoc index d79e46c..004be46 100644 --- a/docs/dzgui_dark.adoc +++ b/docs/dzgui_dark.adoc @@ -102,11 +102,14 @@ Enable a Proton version ≥ `6.8` (or use Proton Experimental) in the `Compatibi === API key & server IDs -==== Steam API key (required) -1. Register for a https://steamcommunity.com/dev/apikey[Steam API key] (free) using your Steam account. You will be asked for a unique URL for your app when registering. +==== Steam Web API key (required) +1. Register for a https://steamcommunity.com/dev/apikey[Steam Web API key] (free) using your Steam account. You will be asked for a unique URL for your app when registering. 2. Since this key is for a personal use application and does not actually call back anywhere, set a generic local identifier here like "127.0.0.1" or some other name that is meaningful to you. 3. Once configured, you can insert this key in the app when launching it for the first time. +[NOTE] +If you are confused about this requirement, please refer to DZGUI Knowledge Base article https://aclist.github.io/dzgui/kb.html#DZG-007[DZG-007] for additional information. + ==== BattleMetrics API key (optional) This key is optional. Using this key in conjunction with the above allows you to also connect to and query servers by numerical ID instead of by IP. See < Add server by ID, Add server by ID>>. diff --git a/docs/kb_sections/dzg007.adoc b/docs/kb_sections/dzg007.adoc index 7dfa44a..af549b9 100644 --- a/docs/kb_sections/dzg007.adoc +++ b/docs/kb_sections/dzg007.adoc @@ -1,17 +1,17 @@ [[DZG-007,DZG-007]] -== DZG-007: Why do I need a Steam API key? Is it safe? +== DZG-007: Why do I need a Steam Web API key? Is it safe? Last updated: {d} -In order to provide a server browser showing a searchable list of all available servers, DZGUI utilizes the Steam API. +In order to provide a server browser showing a searchable list of all available servers, DZGUI utilizes the Steam Web API. Actual connections and queries to individual servers are performed directly between the computer and the DayZ server. -DZGUI gets its server information directly from the most authoritative source: Steam. It does this by letting the user be solely in control of their own API key and the application in an authenticated way. Users explicitly get permission to use an API key instead of scraping DayZ server info from third-party sites. +DZGUI gets its server information directly from the most authoritative source: Steam. It does this by letting the user be solely in control of their own API key and the application in an authenticated way. Users explicitly get permission to use a Web API key instead of scraping DayZ server info from third-party sites. -Everything that happens between DZGUI and Steam takes place solely on the user's computer, and no information gets sent back to the developer. DZGUI does not scrape third party DayZ APIs without permission. +Everything that happens between DZGUI and the Steam Web API endpoint takes place solely on the user's computer, using a GET request (fetch server list), and no information gets sent back to the developer. DZGUI does not scrape third party DayZ APIs without permission. -There is some misconception that a Steam API key could be used to gain information about a user's account or control their account. Not only is this not possible, but the API key is used solely by the user on their own computer and is protected by Steam Guard. +There is some misconception that a Steam Web API key could be used to gain information about a user's account or control their account. Not only is this not possible, but the Web API key is used solely by the user on their own computer and is protected by Steam Guard. -A Steam API key is the most strict way of getting authentic, reliable, and consistent server information in a zero-trust model. +A Steam Web API key is the most strict way of getting authentic, reliable, and consistent server information in a zero-trust model. -You are responsible for the creation, storage, management, and revocation of your API key. +You are responsible for the creation, storage, management, and revocation of your Web API key.