Adds support for economy metrics, store, product, and user finance endpoints (#571)

* Update openapi parameter definitions and add related route handlers to support economy metrics, store listings, products, and user financial data endpoints.

* Restore creator-economy changes after merging origin/main

* Keep economy docs additive to origin/main

* Add support for economy metrics, store listing endpoints, and user Tilia KYC in the API documentation

Extend parameters.yaml with groupByDuration, metricDateStart, and metricDateEnd for economy metrics queries; update path definitions to include stores listing and user Tilia KYC endpoints; adjust schemas for additional fields such as accountId and purchaseCount.

* Update schemas to explicitly include 'format: date-time' for timestamp fields and specify 'format: int64' for transaction identifiers, ensuring consistency and clarity in API data definitions.

Author: Miner28

openapi/components/parameters.yaml

@@ -307,6 +307,14 @@ fuzzy:
   in: query
   schema:
     type: boolean
+groupByDuration:
+  name: groupByDuration
+  description: Time bucket size for economy metrics. Observed values include `days` and `years`.
+  required: false
+  in: query
+  schema:
+    type: string
+    example: days
 groupGalleryId:
   name: groupGalleryId
   description: Must be a valid group gallery ID.
@@ -541,6 +549,22 @@ limit:
   schema:
     type: integer
     example: 100
+listingTypeFilter:
+  name: listingType
+  description: Filter user listings by category. Observed values include `otp` and `subscription`.
+  required: false
+  in: query
+  schema:
+    type: string
+    example: otp
+managementPov:
+  name: managementPov
+  description: Return stores from the seller management point of view.
+  required: false
+  in: query
+  schema:
+    type: boolean
+    example: true
 maxUnityVersion:
   name: maxUnityVersion
   description: The maximum Unity version supported by the asset.
@@ -562,6 +586,22 @@ metadata:
   in: query
   schema:
     type: string
+metricDateEnd:
+  name: metricDateEnd
+  description: Upper bound for economy metrics queries. Observed formats include both date-only and full ISO timestamps.
+  required: false
+  in: query
+  schema:
+    type: string
+    example: 2026-04-04T21:59:59.999Z
+metricDateStart:
+  name: metricDateStart
+  description: Lower bound for economy metrics queries. Observed formats include both date-only and full ISO timestamps.
+  required: false
+  in: query
+  schema:
+    type: string
+    example: 2026-03-28T23:00:00.000Z
 minUnityVersion:
   name: minUnityVersion
   description: The minimum Unity version supported by the asset.
@@ -741,6 +781,20 @@ search:
   in: query
   schema:
     type: string
+sellerId:
+  name: sellerId
+  description: Seller to retrieve economy metrics for.
+  required: true
+  in: query
+  schema:
+    $ref: ./schemas/UserID.yaml
+sellerIdQuery:
+  name: sellerId
+  description: Filter results by seller.
+  required: false
+  in: query
+  schema:
+    $ref: ./schemas/UserID.yaml
 slot:
   name: slot
   description: The message slot to fetch of a given message type.

openapi/components/paths.yaml

@@ -140,6 +140,8 @@
   $ref: "./paths/economy.yaml#/paths/~1economy~1store"
 /economy/store/shelves:
   $ref: "./paths/economy.yaml#/paths/~1economy~1store~1shelves"
+/economy/stores:
+  $ref: "./paths/economy.yaml#/paths/~1economy~1stores"
 "/favorite/group/{favoriteGroupType}/{favoriteGroupName}/{userId}":
   $ref: "./paths/favorites.yaml#/paths/~1favorite~1group~1{favoriteGroupType}~1{favoriteGroupName}~1{userId}"
 /favorite/groups:
@@ -288,6 +290,8 @@
   $ref: "./paths/miscellaneous.yaml#/paths/~1js~1app.js"
 "/licenseGroups/{licenseGroupId}":
   $ref: "./paths/economy.yaml#/paths/~1licenseGroups~1{licenseGroupId}"
+/listing:
+  $ref: "./paths/economy.yaml#/paths/~1listing"
 "/listing/{productId}":
   $ref: "./paths/economy.yaml#/paths/~1listing~1{productId}"
 /logout:
@@ -320,6 +324,8 @@
   $ref: "./paths/prints.yaml#/paths/~1prints~1user~1{userId}"
 "/prints/{printId}":
   $ref: "./paths/prints.yaml#/paths/~1prints~1{printId}"
+/products:
+  $ref: "./paths/economy.yaml#/paths/~1products"
 "/products/{productId}":
   $ref: "./paths/economy.yaml#/paths/~1products~1{productId}"
 /props:
@@ -352,6 +358,12 @@
   $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1balance~1earnings"
 "/user/{userId}/economy/account":
   $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1economy~1account"
+"/user/{userId}/economy/balances":
+  $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1economy~1balances"
+"/user/{userId}/economy/payouts/list":
+  $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1economy~1payouts~1list"
+"/user/{userId}/economy/payouts/status":
+  $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1economy~1payouts~1status"
 "/user/{userId}/economy/transactions":
   $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1economy~1transactions"
 "/user/{userId}/friendRequest":
@@ -362,6 +374,10 @@
   $ref: "./paths/inventory.yaml#/paths/~1user~1{userId}~1inventory~1{inventoryItemId}"
 "/user/{userId}/listings":
   $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1listings"
+"/user/{userId}/products":
+  $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1products"
+"/user/{userId}/tilia/kyc":
+  $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1tilia~1kyc"
 "/user/{userId}/tilia/tos":
   $ref: "./paths/economy.yaml#/paths/~1user~1{userId}~1tilia~1tos"
 /userNotes: