update wordings

Author: maanex

content/3.api-v2/1.introduction.md

@@ -9,16 +9,21 @@ Welcome to FreeStuff's second iteration on our api. Api v2 can do everything v1
 - Streamlined the data obtaining process
 - Built on web standards. See [Standard Webhooks](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md), [Problem JSON](https://datatracker.ietf.org/doc/html/rfc7807), and more
 - Introduction of compatibility dates for seamless api versioning
-- Introduction of a free tier. See pricing for more details
+- Introduction of a free tier
 
 
 ## Pricing
 
-FreeStuff's api comes in two tiers.
+FreeStuff's api comes in two basic tiers.
 
 |                       | Free Tier                                  | Full Tier                                       |
 |-----------------------|--------------------------------------------|-------------------------------------------------|
-| Price                 | $0                                         | $2.99/mo                                        |
+| Price                 | $0                                         | $2.99/mo¹                                       |
 | Channels              | 100% Discount, Free Weekend, DLCs & More   | All Channels, including Prime Gaming            |
 | Data                  | Partial data, no metadata, reduced assets  | Full data, see documentation for more details   |
 | Interface             | Webhooks only                              | Webhooks + REST Api                             |
+| Commercial use        | Prohibited²                                | Prohibited²                                     |
+
+¹ This price is without guarantee. For the actual binding price please check your dashboard.
+
+² There is an additional commercial tier for if you want to use FreeStuff's API or Data in a commercial setting. Please contact us for more information.

content/3.api-v2/2.concepts.md

@@ -13,6 +13,8 @@ Additionally a product has some basic properties like a title, assets (logos, im
 
 Each product has a kind as described earlier. This value describes what kind of product it is. Usually it's a **game**, but others like **dlc** or **loot** for game pass or prime gaming are also possible. FreeStuff also has more types like **art**, **ost**, or **other** which are currently unused.
 
+The Data Models below show compatibility date `2025-03-01`. Newer versions might differ in details.
+
 :data-model{name="Product"}
 :data-model{name="PartialProduct"}
 :data-model{name="ProductPrice"}

content/3.api-v2/3.usage-and-auth.md

@@ -1,5 +1,9 @@
 # Usage & Auth
 
+::alert{type="info"}
+If you are on the free tier and do not have access to the REST Api you can skip this page.
+::
+
 ## Base Url
 
 All endpoints are available on `https://api.freestuffbot.xyz/v2`

content/3.api-v2/4.endpoints.md

@@ -1,5 +1,9 @@
 # Endpoints
 
+::alert{type="info"}
+If you are on the free tier and do not have access to the REST Api you can skip this page.
+::
+
 :endpoint{name="get-ping"}
 
 :endpoint{name="get-products"}

content/3.api-v2/5.webhooks.md

@@ -9,7 +9,7 @@ The message payload (http body) follows the [Standard Webhooks Spec](https://git
 
 ```jsonc
 {
-  "type": "urn:fsb:event:announcement.publish",
+  "type": "fsb:event:announcement.publish",
   "timestamp": "2022-11-03T20:26:10.344522Z",
   "data": {
     // ...
@@ -41,6 +41,10 @@ FreeStuff signs every webhook request as per [Standard Webhooks Spec](https://gi
 - Make sure to ignore requests with an old `Webhook-Timestamp` value
 - Make sure to use the payload body `timestamp` field as the contextual timestamp and use the header only for verification
 
+::alert{type="info"}
+If you are not using a library to verify the request for you and you are not interested in implementing the verification yourself, we recommend you pick a long and unguessable url for your webhook to prevent abuse.
+::
+
 
 ## Resends
 
@@ -67,7 +71,7 @@ FreeStuff attempts to resend failed deliveries as per [Standard Webhooks Spec](h
 
 ## Event List
 
-### urn:fsb:event:ping
+### fsb:event:ping
 
 Fired either when the ping button was pressed on your dashboard or periodically to check if your webhook is still operational.
 
@@ -80,7 +84,7 @@ The `data` field will contain the following object:
 ```
 
 
-### urn:fsb:event:announcement_published
+### fsb:event:announcement-created
 
 Fired when a new announcement is published.
 
@@ -89,7 +93,7 @@ The `data` field will contain a single `ResolvedAnnouncement`. Check it's `resol
 :data-model{name="ResolvedAnnouncement"}
 
 
-### urn:fsb:event:product_updated
+### fsb:event:product-updated
 
 Fired when a previously published product is updated.
 

data/api-v2.json

@@ -3,7 +3,7 @@
   "@": {
     "generic-error": {
       "body": {
-        "type": "urn:fsb:problem:name-here",
+        "type": "fsb:problem:name-here",
         "title": "error name",
         "detail": "error message"
       },