API Overview

Our API allows you to programmatically access all the color tools available on our platform. You can generate color palettes, convert between color formats, check contrast ratios, and more.

Authentication

All API requests require an API key sent in the Authorization header.

curl -X GET \
  https://api.gmeii.site/v1/palette \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json'

You can find your API key in your account settings after subscribing to a paid plan.

API Endpoints

POST /palette
{
  "base_color": "#3B82F6",
  "mode": "analogous",
  "count": 5
}

{
  "status": "success",
  "colors": [
    {"hex": "#3B82F6", "rgb": {"r": 59, "g": 130, "b": 246}},
    {"hex": "#3BF6E5", "rgb": {"r": 59, "g": 246, "b": 229}},
    {"hex": "#3BF665", "rgb": {"r": 59, "g": 246, "b": 101}},
    {"hex": "#F6BA3B", "rgb": {"r": 246, "g": 186, "b": 59}},
    {"hex": "#F63B82", "rgb": {"r": 246, "g": 59, "b": 130}}
  ]
}

POST /convert
{
  "color": "#3B82F6",
  "from": "hex",
  "to": ["rgb", "hsl", "cmyk"]
}

{
  "status": "success",
  "original": {"hex": "#3B82F6"},
  "converted": {
    "rgb": "rgb(59, 130, 246)",
    "hsl": "hsl(217, 92%, 60%)",
    "cmyk": "cmyk(76, 47, 0, 4)"
  }
}

POST /contrast
{
  "foreground": "#000000",
  "background": "#FFFFFF",
  "font_size": "normal"
}

{
  "status": "success",
  "contrast_ratio": 21.0,
  "wcag": {
    "aa": true,
    "aaa": true
  },
  "suggestions": "This combination provides excellent contrast."
}

Rate Limiting

API requests are rate limited to ensure fair usage:

If you exceed these limits, you'll receive a 429 Too Many Requests response. Contact us if you need higher limits for your application.