Vis respekt for andre spillere.
"}}}}}}}}},"/lobbies/shoppylobby/market":{"get":{"operationId":"lobbies-market","tags":["lobbies"],"summary":"Shoppylobby shops and offers","description":"Get active, owned AreaShop regions and their ChestShop offers. The owner is the AreaShop plot owner, independently of the sign owner. Empty active plots have listings: [].\n\nNo parameters are required. The server is fixed to shoppylobby. The response includes both trade directions; this route has no item or plot filter.\n\nB/buyPrice is what the player pays the shop. S/sellPrice is what the shop pays the player. The price covers amount items; divide exactly to calculate the price per item.\n\nPrices are decimal strings. null means that trade direction is unavailable; 0 is a real offer. itemVariantKey is an item fingerprint, not an image URL or necessarily the history endpoint's itemId.\n\nSOLD/RESELL and unexpired RENTED regions can be included. If no unambiguous player record matches the owner UUID, playerID/username are null while the valid owner UUID is retained.\n\nThe HTTP response uses Cache-Control: no-store. The backend normally reuses its catalog for 30 seconds and checks expiration on every request. Mirrored data does not guarantee stock availability.","security":[],"parameters":[],"responses":{"200":{"description":"A catalog containing the server, fetch time, and shops.","content":{"application/json":{"examples":{"example1":{"summary":"A catalog containing the server, fetch time, and shops.","value":{"server":"shoppylobby","fetchedAt":"2030-06-01T12:00:00.000Z","shops":[{"id":"3333333333333333333333333333333333333333333333333333333333333333","server":"shoppylobby","world":"world","regionName":"example_plot","regionType":"RENT","owner":{"playerID":42,"uuid":"00000000-0000-4000-8000-000000000001","username":"ExamplePlayer"},"expiresAt":"2030-06-10T12:00:00.000Z","min":{"x":0,"y":0,"z":0},"max":{"x":15,"y":255,"z":15},"syncedAt":"2030-06-01T11:00:00.000Z","listings":[{"id":"4444444444444444444444444444444444444444444444444444444444444444","server":"shoppylobby","world":"world","regionName":"example_plot","x":5,"y":64,"z":5,"item":"Coal","itemMaterial":"COAL","itemKey":"minecraft:coal","itemJson":{"schemaVersion":1,"id":"minecraft:coal","material":"COAL","iconKey":"coal","amount":64},"itemVariantKey":"2222222222222222222222222222222222222222222222222222222222222222","amount":64,"buyPrice":"8.00000000","sellPrice":"4.00000000","syncedAt":"2030-06-01T11:00:00.000Z"}]}]}}}}}},"503":{"description":"The market is temporarily unavailable. Retry-After: 5.","content":{"application/json":{"examples":{"example2":{"summary":"The market is temporarily unavailable. Retry-After: 5.","value":{"error":"Market temporarily unavailable"}}}}}}}}},"/lobbies/shoppylobby/market/items/{itemId}/history":{"get":{"operationId":"lobbies-market-item-history","tags":["lobbies"],"summary":"An item's best historical prices","description":"Get recorded changes in the best price for one exact frontend item variant. buy tracks the lowest B price; sell tracks the highest S price per item.\n\nOnly direction and range are accepted as query parameters; each must be a single string. Unknown and repeated parameters are rejected.\n\nThe history job checks every 6 hours and stores the first price and unit-price changes. A change of owner or quantity at the same unit price does not create another point.\n\npoints can be empty. The first point may be an earlier observation just before the selected period; its recordedAt is unchanged. from is null for all.\n\nthrough only extends to the last known history update. lastCheckedAt can be null. An offer disappearing is not a zero-price point and does not establish stock or continuous availability.\n\nprice/amount describe the original trade. numerator/denominator give the exact unit price as integer strings; avoid floating-point comparisons.\n\nAt most 2,001 points are returned, including a possible predecessor. Large ranges select the first, last, lowest, and highest changes in chronological buckets across the full period; sampled/totalChanges describe the selection.\n\nHTTP: Cache-Control: no-store. The backend may reuse the same history response for 120 seconds. All timestamp fields are UTC.","security":[],"parameters":[{"name":"itemId","in":"path","required":true,"description":"Exactly 64 lowercase hexadecimal characters: the SHA-256 of the frontend's semantic item identity. Use the item page's id, not the raw itemVariantKey, material, or Minecraft id.","schema":{"type":"string","examples":["1111111111111111111111111111111111111111111111111111111111111111"]}},{"name":"direction","in":"query","required":false,"description":"buy or sell, from the player's perspective. Default: buy.","schema":{"type":"string","examples":["sell"]}},{"name":"range","in":"query","required":false,"description":"1m, 3m, or all. Months are UTC calendar months, with the day clamped to the last day of the target month. Default: 1m.","schema":{"type":"string","examples":["1m"]}}],"responses":{"200":{"description":"Price history with its observation cutoff and any recorded price changes.","content":{"application/json":{"examples":{"example1":{"summary":"Price history with its observation cutoff and any recorded price changes.","value":{"server":"shoppylobby","itemId":"1111111111111111111111111111111111111111111111111111111111111111","direction":"sell","range":"1m","fetchedAt":"2030-06-01T12:30:00.000Z","from":"2030-05-01T12:30:00.000Z","through":"2030-06-01T12:00:00.000Z","lastCheckedAt":"2030-06-01T12:00:00.000Z","sampled":false,"totalChanges":1,"points":[{"recordedAt":"2030-06-01T06:00:00.000Z","price":"8.00000000","amount":64,"numerator":"1","denominator":"8","owner":{"playerID":42,"uuid":"00000000-0000-4000-8000-000000000001","username":"ExamplePlayer"},"world":"world","regionName":"example_plot"}]}}}}}},"400":{"description":"Invalid id, query name, value, or repeated/nested query parameter.","content":{"application/json":{"examples":{"example2":{"summary":"Invalid id, query name, value, or repeated/nested query parameter.","value":{"error":"Invalid market history request"}}}}}},"503":{"description":"History is temporarily unavailable. Retry-After: 5.","content":{"application/json":{"examples":{"example3":{"summary":"History is temporarily unavailable. Retry-After: 5.","value":{"error":"Market history temporarily unavailable"}}}}}}}}},"/storeapi/v2/settings":{"get":{"operationId":"store-settings","tags":["store"],"summary":"Server resource reporting interval","description":"Get the backend's resource settings for the server integration.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\nSeveral errors are returned with HTTP 200 as JSON or text. Check the response body even when the HTTP status is 200.","security":[{"serverKey":[]}],"parameters":[],"responses":{"200":{"description":"Resource interval in seconds; the existing backend returns 300 or 600.\n\nThe server key could not be authenticated.","content":{"application/json":{"examples":{"example1":{"summary":"Resource interval in seconds; the existing backend returns 300 or 600.","value":{"intervals":{"resources":300}}},"example2":{"summary":"The server key could not be authenticated.","value":{"error":"Invalid server api key"}}}}}},"406":{"description":"The server owner's active ban blocks access.","content":{"application/json":{"examples":{"example3":{"summary":"The server owner's active ban blocks access.","value":{"error":"Du er bannet og kan ikke tilgå dette endpoint"}}}}}}}}},"/storeapi/v2/purchases":{"get":{"operationId":"store-purchases","tags":["store"],"summary":"Fetch and renew pending purchases","description":"Poll the server's pending orders. This call renews subscriptions first, so it can change state even though it uses GET.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\namount is the order total; product.price is total/quantity. Preserve the total without unnecessary floating-point rounding.\n\nThe recipient's uuid is used for delivery. The list includes all pending orders for the server; it has no pagination or date-filter parameters.\n\nUse this call from the server integration. Avoid browser/CDN caching and automatic link previews: this GET can change balances and subscription status.\n\nItems and commands are delivered by the server integration; this response does not itself confirm delivery.\n\nChanges data: May create pending subscription orders, debit the player's EMS into escrow, and clear the renewal marker. Expired subscriptions or subscriptions that cannot be paid may be cancelled.","security":[{"serverKey":[]}],"parameters":[],"responses":{"200":{"description":"Pending purchases for the key's server; product is a JSON object.\n\nNo pending purchases, or a missing/unknown key.","content":{"application/json":{"examples":{"example1":{"summary":"Pending purchases for the key's server; product is a JSON object.","value":[{"id":"EXAMPLE_ORDER_UID","amount":"100.00","uuid":"00000000-0000-4000-8000-000000000001","product":{"type":"bulk","id":"example_product","name":"ExampleBundle","price":25,"quantity":4,"duration":null}}]},"example2":{"summary":"No pending purchases, or a missing/unknown key.","value":[]}}}}},"503":{"description":"Renewal failed.","content":{"application/json":{"examples":{"example3":{"summary":"Renewal failed.","value":{"error":"Unable to renew purchases. Please retry."}}}}}}},"x-side-effects":"May create pending subscription orders, debit the player's EMS into escrow, and clear the renewal marker. Expired subscriptions or subscriptions that cannot be paid may be cancelled."},"put":{"operationId":"store-purchases-accept","tags":["store"],"summary":"Accept a pending purchase","description":"Process one pending EMS order after the server's delivery flow. The order is looked up and processed under transaction locks.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\nSeveral errors are returned with HTTP 200 as JSON or text. Check the response body even when the HTTP status is 200.\n\nThere is no idempotency-key field. An already processed purchase is rejected with Purchase is not pending; repeating the call does not return another success confirmation.\n\nThis route does not deliver Minecraft items itself. It cannot process payout orders or DKK payments.\n\nChanges data: Changes the order to accepted, records processed, releases escrow to the shop owner and any revenue-share recipients, and updates the subscription's next renewal when applicable.","security":[{"serverKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"example":{"purchase":"EXAMPLE_ORDER_UID"},"schema":{"type":"object","properties":{"purchase":{"type":"string","examples":["EXAMPLE_ORDER_UID"],"description":"The order UID from the purchase list's id field, 1–255 characters. It must identify one pending EMS order belonging to the key's server. Payout orders cannot be processed here."}},"required":["purchase"]}}}},"responses":{"200":{"description":"The order was processed.\n\nInvalid key, missing purchase, or an order that cannot be processed.\n\nAuthorization is missing.","content":{"text/html":{"examples":{"example1":{"summary":"The order was processed.","value":"success"},"example4":{"summary":"Authorization is missing.","value":"Invalid api key"}}},"application/json":{"examples":{"example2":{"summary":"Invalid key, missing purchase, or an order that cannot be processed.","value":{"error":"Purchase is not pending"}}}}}},"503":{"description":"Processing could not complete. Check the order status before retrying.","content":{"application/json":{"examples":{"example3":{"summary":"Processing could not complete. Check the order status before retrying.","value":{"error":"Unable to process purchase. Please retry."}}}}}}},"x-side-effects":"Changes the order to accepted, records processed, releases escrow to the shop owner and any revenue-share recipients, and updates the subscription's next renewal when applicable."}},"/storeapi/purchases/decline":{"put":{"operationId":"store-purchases-decline","tags":["store"],"summary":"Decline and refund a pending purchase","description":"Decline one pending EMS order for the server. The active decline route does not include /v2.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\nSeveral errors are returned with HTTP 200 as JSON or text. Check the response body even when the HTTP status is 200.\n\nThe refund comes from pending escrow. Payout orders, DKK orders, and already processed orders are rejected.\n\nUse only example UIDs when reading the documentation. A real purchase id affects a real order and balance.\n\nChanges data: Changes the order to denied, records the reason and processing time, returns the reserved EMS to the payer, and cancels the related subscription when applicable.","security":[{"serverKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"example":{"purchase":"EXAMPLE_ORDER_UID","reason":"Example: the item could not be delivered"},"schema":{"type":"object","properties":{"purchase":{"type":"string","examples":["EXAMPLE_ORDER_UID"],"description":"The order UID from the purchase list's id field, 1–255 characters. It must identify one pending EMS order belonging to the key's server. Payout orders cannot be processed here."},"reason":{"type":"string","examples":["Example: the item could not be delivered"],"description":"Optional decline reason. A non-empty string is stored; a missing or non-string value becomes null."}},"required":["purchase"]}}}},"responses":{"200":{"description":"The order was processed.\n\nInvalid key, missing purchase, or an order that cannot be processed.\n\nAuthorization is missing.","content":{"text/html":{"examples":{"example1":{"summary":"The order was processed.","value":"success"}}},"application/json":{"examples":{"example2":{"summary":"Invalid key, missing purchase, or an order that cannot be processed.","value":{"error":"Purchase is not pending"}},"example4":{"summary":"Authorization is missing.","value":[]}}}}},"503":{"description":"Processing could not complete. Check the order status before retrying.","content":{"application/json":{"examples":{"example3":{"summary":"Processing could not complete. Check the order status before retrying.","value":{"error":"Unable to process purchase. Please retry."}}}}}}},"x-side-effects":"Changes the order to denied, records the reason and processing time, returns the reserved EMS to the payer, and cancels the related subscription when applicable."}},"/storeapi/pay":{"post":{"operationId":"store-pay","tags":["store"],"summary":"Pay EMS from the server owner","description":"Transfer EMS from the server owner's balance to a known player and create an accepted payout order with a log entry. This call transfers funds.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\nSeveral errors are returned with HTTP 200 as JSON or text. Check the response body even when the HTTP status is 200.\n\nThe server owner's active global/temp ban blocks the payout; the owner must have sufficient funds.\n\nThere is no idempotency key or replay protection on this route. Repeating a successful request can transfer funds again.\n\nThe example body is synthetic. Only make this call for an intended payout from a trusted server integration.\n\nChanges data: Creates a payout order and EMS log entry, debits the server owner, and credits the recipient's balance.","security":[{"serverKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"example":{"target":"00000000-0000-4000-8000-000000000001","amount":10,"title":"ExamplePayout","description":"Synthetic example, not a real payout"},"schema":{"type":"object","properties":{"target":{"type":"string","examples":["00000000-0000-4000-8000-000000000001"],"description":"A UUID string validated by Zod; the recipient must exist."},"amount":{"type":"number","examples":[10],"description":"EMS amount as a JSON number. Send a positive amount; the existing validator specifies no minimum or maximum."},"title":{"type":"string","examples":["ExamplePayout"],"description":"3–255 characters. The payout order's title."},"description":{"type":"string","examples":["Synthetic example, not a real payout"],"description":"3–255 characters. The payout order's reason."}},"required":["target","amount","title","description"]}}}},"responses":{"200":{"description":"The payout completed.\n\nMissing key; other validation errors are also returned as text.\n\nThe owner has insufficient funds.","content":{"text/html":{"examples":{"example1":{"summary":"The payout completed.","value":"success"},"example2":{"summary":"Missing key; other validation errors are also returned as text.","value":"Invalid api key (1)"},"example3":{"summary":"The owner has insufficient funds.","value":"Insufficent owner balance"}}}}}},"x-side-effects":"Creates a payout order and EMS log entry, debits the server owner, and credits the recipient's balance."}},"/storeapi/v2/votes":{"get":{"operationId":"store-votes","tags":["store"],"summary":"Get the server's pending votes","description":"Get unprocessed votes for the key's server within the current vote window.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\nIncludes today's votes and votes from the last hour. The day boundary follows the database date; the response's date field is a Unix timestamp in milliseconds.\n\nThis GET does not mark votes as processed. Use PUT /storeapi/v2/votes after the server's reward flow.","security":[{"serverKey":[]}],"parameters":[],"responses":{"200":{"description":"A list of vote UIDs, players, and timestamps.\n\nNo matches, or a missing/unknown key.","content":{"application/json":{"examples":{"example1":{"summary":"A list of vote UIDs, players, and timestamps.","value":[{"id":"EXAMPLE_VOTE_UID","username":"ExamplePlayer","uuid":"00000000-0000-4000-8000-000000000001","date":1893499200000}]},"example2":{"summary":"No matches, or a missing/unknown key.","value":[]}}}}}}},"put":{"operationId":"store-votes-process","tags":["store"],"summary":"Mark votes as processed","description":"Set processed on vote UIDs belonging to the key's server. This endpoint does not give the player a reward itself.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\nSeveral errors are returned with HTTP 200 as JSON or text. Check the response body even when the HTTP status is 200.\n\nVotes belonging to other servers are unchanged. Unknown UIDs can still return success: true because affectedRows is not checked.\n\nChanges data: Sets processed to the current time on matching server votes. Repeating the call can change the processed timestamp again.","security":[{"serverKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"example":{"votes":["EXAMPLE_VOTE_UID"]},"schema":{"type":"object","properties":{"votes":{"type":"array","items":{},"examples":[["EXAMPLE_VOTE_UID"]],"description":"A non-empty list of vote UIDs. Send UID strings; the route validates the array and its length, but not each element's type."}},"required":["votes"]}}}},"responses":{"200":{"description":"The update completed; the response does not report the number of matches.\n\nThe body, array, or key is invalid.\n\nAuthorization is missing.","content":{"application/json":{"examples":{"example1":{"summary":"The update completed; the response does not report the number of matches.","value":{"success":true}},"example2":{"summary":"The body, array, or key is invalid.","value":{"error":"Invalid parameters"}},"example3":{"summary":"Authorization is missing.","value":[]}}}}}},"x-side-effects":"Sets processed to the current time on matching server votes. Repeating the call can change the processed timestamp again."}},"/storeapi/v2/votes/players/{uuid}":{"get":{"operationId":"store-player-votes","tags":["store"],"summary":"Get a player's votes on the server","description":"Get all known votes for the player and the key's server, including processed votes. This route has no day filter or pagination.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\ndate is a Unix timestamp in milliseconds. No sort order is guaranteed, and there is no parameter for limiting the history.","security":[{"serverKey":[]}],"parameters":[{"name":"uuid","in":"path","required":true,"description":"The player's UUID. The player must exist; these vote routes use a database lookup without a separate UUID format validator.","schema":{"type":"string","examples":["00000000-0000-4000-8000-000000000001"]}}],"responses":{"200":{"description":"The vote list.\n\nNo matches, or a missing/unknown key.\n\nThe player does not exist.","content":{"application/json":{"examples":{"example1":{"summary":"The vote list.","value":[{"id":"EXAMPLE_VOTE_UID","username":"ExamplePlayer","uuid":"00000000-0000-4000-8000-000000000001","date":1893499200000}]},"example2":{"summary":"No matches, or a missing/unknown key.","value":[]},"example3":{"summary":"The player does not exist.","value":{"error":"Invalid player"}}}}}}}}},"/storeapi/v2/votes/players/{uuid}/pending":{"get":{"operationId":"store-player-pending-vote","tags":["store"],"summary":"Find a player's pending vote","description":"Get one unprocessed vote for the player on the server within the current vote window.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\nIncludes today's votes and votes from the last hour. The day boundary follows the database date; the response's date field is a Unix timestamp in milliseconds.\n\nIf several votes match, one is returned without a guaranteed sort order. The response does not mark it as processed; an unknown server key can return No pending votes.","security":[{"serverKey":[]}],"parameters":[{"name":"uuid","in":"path","required":true,"description":"The player's UUID. The player must exist; these vote routes use a database lookup without a separate UUID format validator.","schema":{"type":"string","examples":["00000000-0000-4000-8000-000000000001"]}}],"responses":{"200":{"description":"One matching vote.\n\nNo matching pending vote.\n\nThe player does not exist.\n\nAuthorization is missing.","content":{"application/json":{"examples":{"example1":{"summary":"One matching vote.","value":{"id":"EXAMPLE_VOTE_UID","username":"ExamplePlayer","uuid":"00000000-0000-4000-8000-000000000001","date":1893499200000}},"example2":{"summary":"No matching pending vote.","value":{"error":"No pending votes"}},"example3":{"summary":"The player does not exist.","value":{"error":"Invalid player"}},"example4":{"summary":"Authorization is missing.","value":[]}}}}}}}},"/storeapi/v2/votes/players/{uuid}/hasvoted":{"get":{"operationId":"store-player-has-voted","tags":["store"],"summary":"Has the player voted on the server?","description":"Check whether a vote exists in the current vote window. Processed votes also count.\n\nThe API key determines the server. These routes do not enforce an IP restriction. Keep the key in server-side code.\n\nIncludes today's votes and votes from the last hour. The day boundary follows the database date; the response's date field is a Unix timestamp in milliseconds.\n\nThis response does not indicate reward delivery or processed status.","security":[{"serverKey":[]}],"parameters":[{"name":"uuid","in":"path","required":true,"description":"The player's UUID. The player must exist; these vote routes use a database lookup without a separate UUID format validator.","schema":{"type":"string","examples":["00000000-0000-4000-8000-000000000001"]}}],"responses":{"200":{"description":"Vote status.\n\nNo matching vote, or an unknown key.\n\nThe player does not exist.\n\nAuthorization is missing.","content":{"application/json":{"examples":{"example1":{"summary":"Vote status.","value":{"hasVoted":true}},"example2":{"summary":"No matching vote, or an unknown key.","value":{"hasVoted":false}},"example3":{"summary":"The player does not exist.","value":{"error":"Invalid player"}},"example4":{"summary":"Authorization is missing.","value":[]}}}}}}}}}}