{"openapi":"3.1.0","info":{"title":"Color API","version":"1.0.0","description":"A complete colour toolkit — convert between hex, RGB, HSL, HSV and CMYK with relative luminance, generate harmonious palettes (complementary, triadic, tetradic, analogous, monochromatic, shades), and compute WCAG contrast ratios with AA/AAA pass-fail for accessibility. Server-side, instant, no third-party services.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/color-api","description":"oanor gateway"}],"tags":[{"name":"Color"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/contrast":{"get":{"operationId":"get_v1_contrast","tags":["Color"],"summary":"WCAG contrast ratio","description":"","parameters":[{"name":"fg","in":"query","required":true,"description":"Foreground colour","schema":{"type":"string"},"example":"ffffff"},{"name":"bg","in":"query","required":true,"description":"Background colour","schema":{"type":"string"},"example":"777777"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"wcag":{"aa_large":true,"aa_normal":false,"aaa_large":false,"aaa_normal":false},"ratio":4.48,"background":"#777777","foreground":"#ffffff"},"meta":{"timestamp":"2026-05-30T06:59:09.647Z","request_id":"864579e5-ab40-4f72-9d25-99d38aa87e3f"},"status":"ok","message":"Contrast computed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Color"],"summary":"Convert a colour","description":"","parameters":[{"name":"color","in":"query","required":true,"description":"hex / short-hex / r,g,b","schema":{"type":"string"},"example":"ff5733"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hex":"#ff5733","hsl":{"h":11,"l":60,"s":100},"hsv":{"h":11,"s":80,"v":100},"rgb":{"b":51,"g":87,"r":255},"cmyk":{"c":0,"k":0,"m":66,"y":80},"is_dark":true,"luminance":0.2832},"meta":{"timestamp":"2026-05-30T06:59:09.727Z","request_id":"a744b384-3e21-4e7e-bdc0-a93f1910adfe"},"status":"ok","message":"Colour converted","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/palette":{"get":{"operationId":"get_v1_palette","tags":["Color"],"summary":"Harmonious palette","description":"","parameters":[{"name":"color","in":"query","required":true,"description":"Base colour","schema":{"type":"string"},"example":"3498db"},{"name":"type","in":"query","required":false,"description":"analogous complementary triadic tetradic monochromatic shades","schema":{"type":"string"},"example":"triadic"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"#3498db","type":"triadic","count":3,"colors":["#3398db","#db3398","#98db33"]},"meta":{"timestamp":"2026-05-30T06:59:09.799Z","request_id":"4b8730c3-eed5-4d18-98c4-2603a9b559f6"},"status":"ok","message":"Palette generated","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":150000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1800,"monthly_call_quota":750000,"rps_limit":35,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4400,"monthly_call_quota":3000000,"rps_limit":90,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/color-api"}