{"info":{"description":"Schreibgeschützte User API des LiveYourLife UCP. Alle Daten werden als JSON ausgegeben. Falls eine Item-Bild-URL nicht geladen werden kann, ist https://a3-cdn.lyl.gg/images/default.png das globale Fallback-Bild.","title":"LiveYourLife UCP User API","version":"1.0.0"},"openapi":"3.1.0","servers":[{"description":"Aktueller UCP-Host","url":"/"}],"tags":[{"description":"Endpunkte für persönliche UCP-Integrationen.","name":"User API"}],"components":{"securitySchemes":{"bearerAuth":{"bearerFormat":"ucp_v1_…","description":"API-Schlüssel aus den UCP-Einstellungen. Sende ihn als `Authorization: Bearer <API_KEY>`.","scheme":"bearer","type":"http"}},"schemas":{"ApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","minLength":1},"message":{"type":"string","minLength":1},"requestId":{"type":"string","minLength":1}},"required":["code","message","requestId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"ItemCatalogResponse":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"description":"Stable item ID."},"illegal":{"type":"boolean","description":"Whether the item is illegal in game."},"imageUrl":{"type":"string","format":"uri","description":"Public image URL for the item. If it cannot be loaded, use the global fallback https://a3-cdn.lyl.gg/images/default.png."},"minimumSellPrice":{"type":["integer","null"],"minimum":0},"name":{"type":"string","minLength":1,"description":"Public display name of the item."},"type":{"type":"string","minLength":1,"description":"Public item type key."},"value":{"type":["integer","null"],"minimum":0},"variant":{"type":"object","properties":{"baseItemId":{"type":["integer","null"],"exclusiveMinimum":0,"description":"Base item ID when this item is a variant; null for the base item."},"groupId":{"type":"integer","exclusiveMinimum":0,"description":"Shared ID used to group a base item with all of its variants."}},"required":["baseItemId","groupId"],"additionalProperties":false},"weight":{"type":"number","minimum":0}},"required":["id","illegal","imageUrl","minimumSellPrice","name","type","value","variant","weight"],"additionalProperties":false}}},"required":["generatedAt","items"],"additionalProperties":false},"CraftingRecipesResponse":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"recipes":{"type":"array","items":{"type":"object","properties":{"inputs":{"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":["integer","null"],"exclusiveMinimum":0,"description":"Stable item ID, if known."},"name":{"type":"string","minLength":1,"description":"Public display name of the item."}},"required":["id","name"],"additionalProperties":false},"quantity":{"type":"integer","exclusiveMinimum":0}},"required":["item","quantity"],"additionalProperties":false},"minItems":1},"level":{"type":"integer","exclusiveMinimum":0},"output":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":["integer","null"],"exclusiveMinimum":0,"description":"Stable item ID, if known."},"name":{"type":"string","minLength":1,"description":"Public display name of the item."}},"required":["id","name"],"additionalProperties":false},"quantity":{"type":"integer","exclusiveMinimum":0}},"required":["item","quantity"],"additionalProperties":false}},"required":["inputs","level","output"],"additionalProperties":false}}},"required":["generatedAt","recipes"],"additionalProperties":false},"ProcessingRecipesResponse":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"recipes":{"type":"array","items":{"type":"object","properties":{"inputs":{"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":["integer","null"],"exclusiveMinimum":0,"description":"Stable item ID, if known."},"name":{"type":"string","minLength":1,"description":"Public display name of the item."}},"required":["id","name"],"additionalProperties":false},"quantity":{"type":"integer","exclusiveMinimum":0}},"required":["item","quantity"],"additionalProperties":false},"minItems":1},"outputs":{"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":["integer","null"],"exclusiveMinimum":0,"description":"Stable item ID, if known."},"name":{"type":"string","minLength":1,"description":"Public display name of the item."}},"required":["id","name"],"additionalProperties":false},"quantity":{"type":"integer","exclusiveMinimum":0}},"required":["item","quantity"],"additionalProperties":false},"minItems":1},"requiredLicense":{"type":["object","null"],"properties":{"name":{"type":"string","minLength":1,"description":"Public display name of the license."}},"required":["name"],"additionalProperties":false,"description":"Required processing license, or null when none is required."}},"required":["inputs","outputs","requiredLicense"],"additionalProperties":false}}},"required":["generatedAt","recipes"],"additionalProperties":false},"HousesResponse":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"houses":{"type":"array","items":{"type":"object","properties":{"access":{"type":"string","enum":["owner","key","gang"],"description":"How the API key owner can access this house."},"id":{"type":"integer","exclusiveMinimum":0},"name":{"type":"string","minLength":1},"storage":{"type":"object","properties":{"capacity":{"type":["number","null"],"minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":["integer","null"],"exclusiveMinimum":0,"description":"Stable item ID, if known."},"name":{"type":"string","minLength":1,"description":"Public display name of the item."}},"required":["id","name"],"additionalProperties":false},"quantity":{"type":"integer","exclusiveMinimum":0}},"required":["item","quantity"],"additionalProperties":false}},"used":{"type":"number","minimum":0}},"required":["capacity","items","used"],"additionalProperties":false}},"required":["access","id","name","storage"],"additionalProperties":false}}},"required":["generatedAt","houses"],"additionalProperties":false},"HouseLogResponse":{"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"actor":{"type":"object","properties":{"name":{"type":["string","null"],"minLength":1}},"required":["name"],"additionalProperties":false},"changes":{"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":["integer","null"],"exclusiveMinimum":0,"description":"Stable item ID, if known."},"name":{"type":"string","minLength":1,"description":"Public display name of the item."}},"required":["id","name"],"additionalProperties":false},"quantityDelta":{"type":"integer"}},"required":["item","quantityDelta"],"additionalProperties":false}},"endedAt":{"type":"string","format":"date-time"},"eventCount":{"type":"integer","exclusiveMinimum":0},"startedAt":{"type":"string","format":"date-time"}},"required":["actor","changes","endedAt","eventCount","startedAt"],"additionalProperties":false}},"generatedAt":{"type":"string","format":"date-time"},"house":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"name":{"type":"string","minLength":1}},"required":["id","name"],"additionalProperties":false}},"required":["entries","generatedAt","house"],"additionalProperties":false}},"parameters":{}},"paths":{"/api/v1/items":{"get":{"description":"Liefert den aktuellen Item-Katalog mit öffentlichen Itemdaten, Preisen und Variantenzuordnung.\n\nErforderlicher Scope: `items:read`.","operationId":"listItems","security":[{"bearerAuth":[]}],"summary":"Items abrufen","tags":["User API"],"responses":{"200":{"description":"Aktueller Item-Katalog.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemCatalogResponse"}}}},"401":{"description":"API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Scope fehlt oder der Benutzer erfüllt die Zugriffsbedingungen nicht.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Ressource wurde nicht gefunden.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate-Limit von 30 Anfragen pro Minute wurde überschritten.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Interner Serverfehler.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/crafting/recipes":{"get":{"description":"Liefert alle aktuellen Crafting-Rezepte mit aufgelösten Item-Informationen.\n\nErforderlicher Scope: `crafting-recipes:read`.","operationId":"listCraftingRecipes","security":[{"bearerAuth":[]}],"summary":"Crafting-Rezepte abrufen","tags":["User API"],"responses":{"200":{"description":"Aktuelle Crafting-Rezepte.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CraftingRecipesResponse"}}}},"401":{"description":"API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Scope fehlt oder der Benutzer erfüllt die Zugriffsbedingungen nicht.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Ressource wurde nicht gefunden.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate-Limit von 30 Anfragen pro Minute wurde überschritten.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Interner Serverfehler.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/processing/recipes":{"get":{"description":"Liefert alle aktuellen Verarbeitungsrezepte mit aufgelösten Item-Informationen und öffentlichen Lizenznamen.\n\nErforderlicher Scope: `processing-recipes:read`.","operationId":"listProcessingRecipes","security":[{"bearerAuth":[]}],"summary":"Verarbeitungsrezepte abrufen","tags":["User API"],"responses":{"200":{"description":"Aktuelle Verarbeitungsrezepte.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessingRecipesResponse"}}}},"401":{"description":"API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Scope fehlt oder der Benutzer erfüllt die Zugriffsbedingungen nicht.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Ressource wurde nicht gefunden.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate-Limit von 30 Anfragen pro Minute wurde überschritten.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Interner Serverfehler.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/houses":{"get":{"description":"**WIP:** Dieser Endpunkt ist noch nicht verfügbar und antwortet derzeit mit HTTP 503.\n\nLiefert die eigenen Häuser und das aktive Gang-Lagerhaus. Diese Route setzt VIP-Hauszugriff voraus.\n\nErforderlicher Scope: `houses:read`.","operationId":"listOwnedHouses","security":[{"bearerAuth":[]}],"summary":"[WIP] Eigene Häuser abrufen","tags":["User API"],"responses":{"200":{"description":"Für den Schlüsselinhaber sichtbare Häuser.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HousesResponse"}}}},"401":{"description":"API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Scope fehlt oder der Benutzer erfüllt die Zugriffsbedingungen nicht.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Ressource wurde nicht gefunden.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate-Limit von 30 Anfragen pro Minute wurde überschritten.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Interner Serverfehler.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Endpunkt ist noch in Entwicklung und derzeit nicht verfügbar.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/houses/{houseId}/logs":{"get":{"description":"**WIP:** Dieser Endpunkt ist noch nicht verfügbar und antwortet derzeit mit HTTP 503.\n\nLiefert die Hauslogs der letzten sieben Tage. Das Haus muss dem Schlüsselinhaber gehören oder sein aktives Gang-Lagerhaus sein; VIP-Hauszugriff ist erforderlich.\n\nErforderlicher Scope: `house-logs:read`.","operationId":"getOwnedHouseLogs","security":[{"bearerAuth":[]}],"summary":"[WIP] Hauslogs abrufen","tags":["User API"],"parameters":[{"schema":{"type":"string","pattern":"^\\d+$"},"required":true,"name":"houseId","in":"path"}],"responses":{"200":{"description":"Hauslogs der letzten sieben Tage.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HouseLogResponse"}}}},"401":{"description":"API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Scope fehlt oder der Benutzer erfüllt die Zugriffsbedingungen nicht.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Ressource wurde nicht gefunden.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate-Limit von 30 Anfragen pro Minute wurde überschritten.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Interner Serverfehler.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Endpunkt ist noch in Entwicklung und derzeit nicht verfügbar.","headers":{"x-ratelimit-limit":{"description":"Maximale Anzahl von Anfragen pro Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"Zeitpunkt, zu dem das Rate-Limit zurückgesetzt wird.","schema":{"format":"date-time","type":"string"}},"x-request-id":{"description":"Korrelations-ID für Support und Fehleranalyse.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"webhooks":{}}