{"openapi":"3.1.0","info":{"title":"MusicBrainz Cache API","version":"0.1.0"},"servers":[{"url":"/api"}],"paths":{"/home":{"get":{"summary":"Get Stats","operationId":"get_stats_home_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Read Root","operationId":"read_root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/artist/{mbid}":{"get":{"summary":"Get Artist","operationId":"get_artist_artist__mbid__get","parameters":[{"name":"mbid","in":"path","required":true,"schema":{"type":"string","title":"Mbid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/artist/{mbid}/external-links":{"get":{"summary":"Get Artist External Links","operationId":"get_artist_external_links_artist__mbid__external_links_get","parameters":[{"name":"mbid","in":"path","required":true,"schema":{"type":"string","title":"Mbid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/release-group/{mbid}":{"get":{"summary":"Get Release Group","operationId":"get_release_group_release_group__mbid__get","parameters":[{"name":"mbid","in":"path","required":true,"schema":{"type":"string","title":"Mbid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/release/{mbid}":{"get":{"summary":"Get Release","operationId":"get_release_release__mbid__get","parameters":[{"name":"mbid","in":"path","required":true,"schema":{"type":"string","title":"Mbid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/recording/{mbid}":{"get":{"summary":"Get Recording","operationId":"get_recording_recording__mbid__get","parameters":[{"name":"mbid","in":"path","required":true,"schema":{"type":"string","title":"Mbid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/work/{mbid}":{"get":{"summary":"Get Work","operationId":"get_work_work__mbid__get","parameters":[{"name":"mbid","in":"path","required":true,"schema":{"type":"string","title":"Mbid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search":{"get":{"summary":"Search","operationId":"search_search_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"artist","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Artist"}},{"name":"release_group","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Group"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release"}},{"name":"recording","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording"}},{"name":"work","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Work"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/awards/albums":{"get":{"summary":"Get Awards Albums","description":"有获奖记录的专辑（release group）列表 —— 数据源 Wikidata，只读本地表。\n\ninclude_nominations=true 时把「只有提名」的专辑也算进来，条目里带 result 字段。","operationId":"get_awards_albums_awards_albums_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":300,"title":"Limit"}},{"name":"include_nominations","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Nominations"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/awards/artists":{"get":{"summary":"Get Awards Artists","description":"有获奖记录的艺人列表。","operationId":"get_awards_artists_awards_artists_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":300,"title":"Limit"}},{"name":"include_nominations","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Nominations"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/awards/summary":{"get":{"summary":"Get Awards Summary","description":"奖项数据概览：各实体类型的获奖/提名条目数与实体数。","operationId":"get_awards_summary_awards_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cover/{entity_type}/{entity_id}":{"get":{"summary":"Get Cover","description":"Get cover art for entity (recording, release, release-group).\nTriggers the fallback chain: Recording -> Release -> Release Group -> Apple Music -> S3","operationId":"get_cover_cover__entity_type___entity_id__get","parameters":[{"name":"entity_type","in":"path","required":true,"schema":{"type":"string","title":"Entity Type"}},{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","title":"Entity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}