{"openapi":"3.0.0","info":{"title":"lavabos-fib Photo API","version":"1.0.0","description":"API de fotos per a lavabos-fib. Proporciona accés a la galeria, fotos de l'equip i el logotip."},"servers":[{"url":"https://api.lavabos-fib.microones.cat","description":"Servidor principal"}],"paths":{"/api/v1/photos/gallery":{"get":{"summary":"Llista totes les fotos de la galeria","operationId":"getGallery","responses":{"200":{"description":"Fotos agrupades per any i edifici","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/YearImages"}}}}}}}}}},"/api/v1/photos/gallery/{year}":{"get":{"summary":"Fotos de la galeria per any","operationId":"getGalleryByYear","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"string","example":"2025"}}],"responses":{"200":{"description":"Fotos per any","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/YearImages"}}}}}},"404":{"description":"Any no trobat"}}}},"/api/v1/photos/gallery/{year}/{building}":{"get":{"summary":"Fotos per any i edifici","operationId":"getGalleryByBuilding","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"string","example":"2025"}},{"name":"building","in":"path","required":true,"schema":{"type":"string","example":"B5"}}],"responses":{"200":{"description":"Fotos de l'edifici","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BuildingImages"}}}}}},"404":{"description":"Any o edifici no trobat"}}}},"/api/v1/photos/about":{"get":{"summary":"Fotos dels membres de l'equip","operationId":"getAboutPhotos","responses":{"200":{"description":"Llista de fotos de membres","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MemberPhoto"}}}}}}}}}},"/api/v1/photos/about/{member}":{"get":{"summary":"Foto d'un membre concret","operationId":"getAboutMember","parameters":[{"name":"member","in":"path","required":true,"schema":{"type":"string","example":"yeray-zalaya"}}],"responses":{"200":{"description":"Foto del membre","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MemberPhoto"}}}}}},"404":{"description":"Membre no trobat"}}}},"/api/v1/photos/logo":{"get":{"summary":"Metadades del logotip","operationId":"getLogo","responses":{"200":{"description":"URL i nom del fitxer del logotip","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/LogoMeta"}}}}}},"404":{"description":"Logotip no trobat"}}}},"/api/v1/photos/file/{path}":{"get":{"summary":"Serveix un fitxer d'imatge","operationId":"getFile","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string","example":"2025/B5/photo1.jpg"},"description":"Ruta relativa al directori d'imatges"}],"responses":{"200":{"description":"Fitxer d'imatge","content":{"image/jpeg":{},"image/png":{},"image/gif":{},"image/webp":{},"image/svg+xml":{}}},"403":{"description":"Accés denegat (traversal de ruta o extensió no permesa)"},"404":{"description":"Fitxer no trobat"}}}}},"components":{"schemas":{"BuildingImages":{"type":"object","properties":{"building":{"type":"string","example":"B5"},"images":{"type":"array","items":{"type":"string","format":"uri","example":"https://api.lavabos-fib.microones.cat/api/v1/photos/file/2025/B5/photo1.jpg"}}}},"YearImages":{"type":"object","properties":{"year":{"type":"string","example":"2025"},"buildings":{"type":"array","items":{"$ref":"#/components/schemas/BuildingImages"}}}},"MemberPhoto":{"type":"object","properties":{"member":{"type":"string","example":"yeray-zalaya"},"filename":{"type":"string","example":"yeray-zalaya.jpeg"},"url":{"type":"string","format":"uri","example":"https://api.lavabos-fib.microones.cat/api/v1/photos/file/about/yeray-zalaya.jpeg"}}},"LogoMeta":{"type":"object","properties":{"filename":{"type":"string","example":"logo_lavabos-fib.png"},"url":{"type":"string","format":"uri","example":"https://api.lavabos-fib.microones.cat/api/v1/photos/file/logo_lavabos-fib.png"}}}}}}