Merge pull request #6 from Daniel-Ric/feature/2026-01-21/find-out-what-he-means-n0dhm7

Clarify PlayFab e9d1 test endpoint inputs and support title-id overrides

Author: Daniel-Ric

README.md

@@ -194,6 +194,8 @@ curl -X POST http://localhost:3000/inventory/playfab   -H "Authorization: Bearer
 ```bash
 curl -X POST http://localhost:3000/inventory/playfab/test   -H "Authorization: Bearer <JWT>"   -H "Content-Type: application/json"   -d '{"playfabToken":"XBL3.0 x=<uhs>;<xstsToken>","entityType":"title_player_account","count":50}'
 ```
+* `playfabToken` comes from `POST /auth/callback` in this API (response field `playfabToken`).
+* Use `entityType=master_player_account` to target the master entity. If you want a specific entity id, pass `entityId`. Otherwise the service uses the PlayFabId returned by LoginWithXbox.
 
 ### 10) Captures (screenshots) → `/captures/screenshots`
 ```bash

src/routes/inventory.routes.js

@@ -89,16 +89,19 @@ router.post("/playfab", jwtMiddleware, asyncHandler(async (req, res) => {
  *               playfabToken:
  *                 type: string
  *                 description: PlayFab XSTS token in the form XBL3.0 x={uhs};{token}
+ *                 example: "XBL3.0 x=<uhs>;<xstsToken>"
  *               entityType:
  *                 type: string
  *                 enum: [title_player_account, master_player_account]
  *                 default: title_player_account
+ *                 example: "title_player_account"
  *               entityId:
  *                 type: string
  *                 description: Optional entity id override for the chosen entity type
  *               collectionId:
  *                 type: string
  *                 default: "default"
+ *                 example: "default"
  *               count:
  *                 type: integer
  *                 default: 50