Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/color-converter

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Converta cores entre os formatos HEX, RGB e HSL instantaneamente. Envie uma cor em qualquer um dos três formatos suportados e receba os valores equivalentes nos três, eliminando cálculos manuais de conversão em ferramentas de design, sistemas de temas e geradores de CSS.

​
Casos de uso

  • Converter cores de marca entre formatos para sistemas de design multiplataforma
  • Gerar propriedades CSS personalizadas em todos os formatos a partir de uma única fonte
  • Validar entradas de cor em interfaces de design ou configuração
  • Transformar exportações de paleta de ferramentas de design em formatos amigáveis para desenvolvedores

​
Detalhes

Valores HEX devem incluir o prefixo # (ex.: #ff5733). Os componentes RGB são inteiros de 0 a 255. O matiz HSL vai de 0 a 360 graus; saturação e luminosidade são porcentagens de 0 a 100.

​
Corpo da requisição

Forneça exatamente um de hex, rgb ou hsl.
CampoTipoObrigatórioDescrição
hexstringNãoString de cor hexadecimal (ex.: #ff5733)
rgbobjectNãoObjeto RGB com campos inteiros r, g, b (0 a 255)
hslobjectNãoObjeto HSL com campos h (0 a 360), s (0 a 100), l (0 a 100)

​
Exemplo — a partir de HEX

{
  "hex": "#ff5733"
}

​
Exemplo — a partir de RGB

{
  "rgb": { "r": 255, "g": 87, "b": 51 }
}

​
Exemplo — a partir de HSL

{
  "hsl": { "h": 11, "s": 100, "l": 60 }
}

​
Resposta

​
200 OK

CampoTipoDescrição
hexstringRepresentação HEX
rgbobjectRepresentação RGB
hslobjectRepresentação HSL
Exemplo 
{
  "hex": "#ff5733",
  "rgb": { "r": 255, "g": 87, "b": 51 },
  "hsl": { "h": 11, "s": 100, "l": 60 }
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

{
  "detail": "Provide exactly one of: hex, rgb, hsl"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/color-converter \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"hex": "#ff5733"}'