{"openapi":"3.0.0","info":{"title":"colors-cc API","version":"1.0.0","description":"ランダム色、配色、SVGプレースホルダーを作成するステートレスAPIです。AIエージェントと開発者向けに設計されています。","contact":{"url":"https://colors-cc.top"}},"servers":[{"url":"https://api.colors-cc.top","description":"APIサーバー"}],"paths":{"/random":{"get":{"operationId":"getRandomColor","summary":"ランダムなHEX・RGB色を取得","description":"ランダムな色をHEX、RGB、タイムスタンプとともに返します。","responses":{"200":{"description":"正常なレスポンス","content":{"application/json":{"schema":{"type":"object","properties":{"hex":{"type":"string","example":"#A1B2C3","description":"6桁のHEXカラーコード"},"rgb":{"type":"string","example":"rgb(161, 178, 195)","description":"RGB形式の色"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601形式のタイムスタンプ"}},"required":["hex","rgb","timestamp"]}}}}}}},"/palette":{"get":{"operationId":"getPalette","summary":"テーマ別の配色を取得","description":"指定したテーマに応じた配色を返します。","parameters":[{"name":"theme","in":"query","description":"配色のテーマ名","schema":{"type":"string","enum":["cyberpunk","vaporwave","retro","monochrome"],"default":"cyberpunk"}}],"responses":{"200":{"description":"テーマ名と色の配列を含む配色","content":{"application/json":{"schema":{"type":"object","properties":{"theme":{"type":"string","example":"cyberpunk"},"colors":{"type":"array","items":{"type":"string"},"example":["#FCEE09","#00FF41","#00B8FF"]},"count":{"type":"integer","example":5}}}}}}}}},"/convert":{"get":{"operationId":"convertColor","summary":"色の形式を変換","description":"HEX、RGB、HSL、CMYK間で色を変換します。入力パラメーターは1つだけ指定してください。","parameters":[{"name":"hex","in":"query","description":"HEX色（例：%23FF5733 または FF5733）","schema":{"type":"string"}},{"name":"rgb","in":"query","description":"RGB色（例：rgb(255,87,51)）","schema":{"type":"string"}},{"name":"hsl","in":"query","description":"HSL色（例：hsl(10,100%,60%)）","schema":{"type":"string"}},{"name":"cmyk","in":"query","description":"CMYK色（例：cmyk(0%,65%,80%,0%)）","schema":{"type":"string"}}],"responses":{"200":{"description":"すべての形式に変換した色","content":{"application/json":{"schema":{"type":"object","properties":{"hex":{"type":"string","example":"#FF5733"},"rgb":{"type":"string","example":"rgb(255, 87, 51)"},"hsl":{"type":"string","example":"hsl(10, 100%, 60%)"},"cmyk":{"type":"string","example":"cmyk(0%, 66%, 80%, 0%)"}}}}}},"400":{"description":"入力が無効、またはパラメーターが未指定","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Invalid color format"}}}}}}}}},"/all-names":{"get":{"operationId":"getColorNames","summary":"すべてのCSS色名を取得","description":"すべての標準CSS色名とHEX値の対応表を返します。","responses":{"200":{"description":"色名をキー、HEX値を値とするオブジェクト","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"example":{"AliceBlue":"#F0F8FF","Tomato":"#FF6347"}}}}}}}},"/placeholder":{"get":{"operationId":"generatePlaceholder","summary":"SVGプレースホルダー画像を作成","description":"サイズ、文字、配色、効果を指定してグラデーションSVG画像を作成します。","parameters":[{"name":"w","in":"query","description":"幅（ピクセル）","schema":{"type":"integer","minimum":50,"maximum":4000,"default":800}},{"name":"h","in":"query","description":"高さ（ピクセル）","schema":{"type":"integer","minimum":50,"maximum":4000,"default":400}},{"name":"text","in":"query","description":"中央の文字（省略時はサイズを表示）","schema":{"type":"string","maxLength":100}},{"name":"effect","in":"query","description":"画像の効果","schema":{"type":"string","enum":["static","fluid","breathe","holographic","mesh"],"default":"static"}},{"name":"palette","in":"query","description":"HEX、RGB、HSL形式の色をカンマで区切ります（2〜10色、初期値はランダムな2色）。例：%23FFD6A5,%23FFADAD","schema":{"type":"string"}},{"name":"speed","in":"query","description":"静止以外の効果の周期（秒）","schema":{"type":"integer","minimum":1,"maximum":30,"default":10}},{"name":"attribution","in":"query","description":"ブランドの透かしを表示（初期値true）。falseまたは0で非表示","schema":{"type":"string","default":"true"}}],"responses":{"200":{"description":"SVGプレースホルダー画像","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"public, max-age=31536000, immutable"}},"content":{"image/svg+xml":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"サイズ、配色、効果、周期、文字のパラメーターが無効"}}}},"/fluid-placeholder":{"get":{"operationId":"generateFluidPlaceholder","summary":"動くグラデーションSVGを作成","description":"/placeholder?effect=fluid の別名です。色がなめらかに変化し、繰り返し再生されるSVGを作成します。","parameters":[{"name":"w","in":"query","description":"幅（ピクセル）","schema":{"type":"integer","minimum":50,"maximum":4000,"default":800}},{"name":"h","in":"query","description":"高さ（ピクセル）","schema":{"type":"integer","minimum":50,"maximum":4000,"default":400}},{"name":"palette","in":"query","description":"HEX、RGB、HSL形式の色をカンマで区切ります（2〜10色、初期値はランダムな2色）。例：%23FFD6A5,%23FFADAD","schema":{"type":"string"}},{"name":"speed","in":"query","description":"アニメーションの周期（秒）","schema":{"type":"integer","minimum":1,"maximum":30,"default":10}},{"name":"text","in":"query","description":"中央の文字（任意）","schema":{"type":"string","maxLength":100}},{"name":"attribution","in":"query","description":"ブランドの透かしを表示（初期値true）。falseまたは0で非表示","schema":{"type":"string","default":"true"}}],"responses":{"200":{"description":"アニメーションSVG画像","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"public, max-age=31536000, immutable"}},"content":{"image/svg+xml":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"サイズ、配色、周期、文字のパラメーターが無効"}}}}}}