1 回の API 呼び出しで 16 進数、RGB、HSL の間で色を変換
カラーを HEX、RGB、または HSL として送信し、3 つの表現すべてを 1 つの POST で取得します。 カラー ライブラリを使用せずに、デザイン トークンを構築し、CMS 入力を正規化し、テーマ スケールを生成します。
色変換の計算は、一度書いたら微妙に間違って、次から次へとコピーするようなコードです。 プロジェクトは永遠に続きます。 16 進数から RGB への変換は簡単です。 RGB から HSL への変換には、1 度ずれたバグが発生します 生きる。 このエンドポイントは 3 つの形式のいずれかで色を受け取り、3 つすべてを一度に返します。 変換関数を持ち歩くのをやめます。
リクエスト
応答により、16 進数の文字列が得られます。 {`{ r, g, b }`} オブジェクトと
{`{ h, s, l }`} 一緒にオブジェクト:
入力形式は関係ありません。 合格 rgb(62, 201, 151) または HSL 文字列を使用すると、
同じ 3 つの表現が戻ってきます。 Hex は、 #:
1つのブランドカラーからデザイントークンスケールを生成
HSL は構築する価値のある形式です。 色相と明度を分離するので、 色相と彩度を一定に保ち、明度の値を段階的に変化させることにより、完全な色合いと色合いのスケールを実現します。 ブランドヘックスを一度 HSL に変換し、次に明度を調べて 50 ~ 900 のスケールを生成します。 デザインシステムには次のものが必要です。
これをビルドステップで実行し、出力を CSS 変数ファイルに書き込みます。 コーディネートが得られます 単一のソース カラーからパレットを作成し、ブランド カラーを変更するとスケール全体が再生成されます。
単一の変換ではなく完全なパレットが必要ですか? の /v1/color/palette
エンドポイントは 1 つの基本色を受け取り、調整された色合いと補色のセットを返します。
そのため、各色見本を手で選択することなく、ブランドカラーをテーマにすることができます。
CMS に貼り付けられたカラーを正規化する
コンテンツ エディターは、デザイン ツールがエクスポートする形式 (Figma からの 16 進数、
rgb() スクリーンショット ツールから、CSS スニペットから HSL を取得します。 貼り付けたすべての値を実行する
正規化された 16 進数を保存して保存するときにエンドポイントを経由します。 レンダリング コードは次の 1 つを処理します。
形式を変更すると、エディターは都合のよいものを貼り付け続けます。
どこに当てはまるか
ブラウザーでの対話型 UI 計算の場合は、ローカル関数で十分です。 API がビルドに組み込まれる ステップ、バックエンド、単色パッケージのない言語: 単一の HTTP 呼び出しが 依存性。 カラー変換は、botoi 上の約 200 の単一目的エンドポイントの 1 つであり、すべて背後にあります。 5 リクエスト/分で 1 つのキーが無料。
で変換を試してください。 インタラクティブな遊び場、 閲覧する 完全な API ドキュメント、 または接続します MCPサーバー クロードまたはカーソルから直接色を変換します。
FAQ
- API はどのようなカラー形式を受け入れ、返しますか?
- カラーを HEX、RGB、または HSL として送信すると、応答は 3 つの表現すべてを一度に返します。 16 進文字列は、先頭に # 接頭辞があってもなくても機能します。 1 回の呼び出しで 16 進文字列、{r, g, b} オブジェクト、および {h, s, l} オブジェクトが得られるため、変換計算を手動で記述する必要はありません。
- ブラウザではなく API を介して色を変換するのはなぜですか?
- 1 回限りの UI 計算の場合は、ブラウザーで実行します。 API は、ビルド ステップとバックエンドでその役割を果たします。ビルド時のデザイン トークンの生成、CMS に貼り付けられたカラーの正規化、カラー ライブラリを出荷したくないサーバー側でのテーマ アセットの生成などを行います。 これは、適切なカラー パッケージを持たない言語を含む、任意の言語からの 1 つの HTTP 呼び出しです。
- 1 つの色を変換するだけでなく、完全なパレットを生成できますか?
- はい。 カラー/パレット エンドポイントはベース カラーを受け取り、調整された色合いと補色のセットを返します。 既知の色があり、その他の表現が必要な場合はカラー/変換を使用し、ブランド カラーが 1 つあり、それを中心にテーマを構築するスケールが必要な場合はカラー/パレットを使用します。
- HSL 値はテーマ設定にどのように役立ちますか?
- HSL は色相を彩度および明度から分離するため、色相と彩度を一定に保ち、明度を段階的に変化させることで、色合いと色合いのスケールを構築できます。 これは、3 つの RGB チャネルを微調整するよりもはるかに簡単です。 ブランド ヘックスを HSL に一度変換し、明度の値を計算して 50 ~ 900 のスケールを生成します。
- カラー API は無料で使用できますか?
- はい。 カラー変換は、他の botoi と同じ無料枠内にあります。API キーは不要で 1 分あたり 5 リクエスト、有料プランでは制限が高くなります。 これは、1 つのキーの下にある約 200 の単一目的エンドポイントの 1 つです。
botoiで開発を始めよう
150以上のAPIエンドポイント。検索、テキスト処理、画像生成、開発者ユーティリティに対応。無料プラン、クレジットカード不要。