新機能: API V2が利用可能になりました。

APIを拡張し、さらに改善しました。V2がオンラインになりました。ウェブプロジェクト、プラグイン、社内ツール、SaaSアプリケーションに最適です。

キャンペーン期間を1ヶ月延長いたします。

今すぐ見る X

V2 新規 – qConv.com カラーコンバータ - API ドキュメント

qConv APIを使用すると、RGB、HEX、CMYK、PANTONE®、RAL、HKS、NCS、およびカスタムメーカーパレットなど、さまざまなフォーマット間で色を変換できます。

🔑 認証

APIはAPIキーを使用します。

URLパラメータによる認証

GET /api/v2/convert.php?from=hex&input=FF0000&to=ral&apikey=[APIキー]

注意:キーはBase64URLエンコード(URL互換)されており、安全です。

🔗 終点

GET https://qconv.com/api/v2/convert.php

📥 お問い合わせパラメーター

パラメータ タイプ 必須 概要
from string ✅ はい 色の出典形式(rgb、ral、behrなどのメーカー名など
input string ✅ はい 入力値(例:FF0000
to string ✅ はい 色のターゲットフォーマット(例:hex、cmyk、またはCaparol Colorなどのメーカー名
apikey string ✅ はい 個人用の秘密のAPIキー

対応フォーマット

カラーフォーマット

rgb hex cmyk pantone ral hks ncs sw

メーカーカラー

以下のリンク先のメーカーページにあるメーカーコードもすべて有効な値です。

https://qconv.com/ja/会

メーカーのウェブサイトの左側の列にあるAPIコードリファレンスを探してください。または、次のシンボルを探してください。:

✅ お問い合わせ例

六角形 まで ラグビー

GET /api/v2/convert.php?from=hex&input=FF0000&to=rgb&apikey=[APIキー]

答えてくれ:

{
    "api_version" => "v2",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "hex",
    "input": "ffa500",
    "to": "rgb",
    "result": "255 165 0",
    "name": "Orange",
    "more_conversions": {
        "pantone": "185",
        "ral": "3026",
        "hks": "10",
        "rgb": "255 0 0",
        "hex": "#FF0000",
        "cmyk": "0 100 100 0",
        "sw": "2910",
        "ncs": "S1085-Y90R"
    },
    "user_data": {
        "username": "USER #12345",
        "used tokens": 1,
        "max tokens": 50,
        "percentage used": "2 %"
    }
}

ラグビー まで メーカーカラー BEHR

GET /api/v2/convert.php?from=rgb&input=145, 25, 100&to=behr&apikey=[APIキー]

答えてくれ:

{
    "api_version" => "v2",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "rgb",
    "input": "145, 25, 100",
    "to": "behr",
    "result": "p120-7 glitterati",
    "deltaE00": "11.2"
    "match_percent": "93.1%",
    "more_conversions": {
        "pantone": "7649",
        "ral": "4006",
        "hks": "28",
        "rgb": "145 25 100",
        "hex": "#911964",
        "cmyk": "0 83 31 43",
        "sw": "6842",
        "ncs": "S3055-R30B"
    },
    "user_data": {
        "username": "USER #12345",
        "used tokens": 2,
        "max tokens": 50,
        "percentage used": "4 %"
    }
}

📦 応答体制

フィールド タイプ 概要
api_version string 現在使用されているAPIのバージョンを返します。
timestamp string ISO 8601形式のリクエストのタイムスタンプ、例:'2025-08-14T13:42:00+01:00'
http_response_code string レスポンスのHTTPステータスコード(200、400、500など)。リクエストが成功したか、エラーを返したかを示します。
from string 送信出力フォーマット
input string 送信元の値
to string 送信対象フォーマット
result string 変換結果
name string/null シャーウィン・ウィリアムズの色指定、NCS(ドイツ語)、HEX(利用可能な場合)、RGB(利用可能な場合)
deltaE00 string/null DeltaE2000 値 (ΔE₀₀) としての色の違い。Delta E 2000またはdE₀については、以下のを参照してください。
match_percent string/null 一致するメーカーカラーをパーセンテージで検索する場合のカラーマッチングに関する注意事項。例'match_percent': '92.2%',
メーカーカラーに変換した場合のみ出力されます。
more_conversions object その他の利用可能なすべての並列変換を配列として
user_data object 使用されたコンバージョン数など、APIアカウントに関する情報。
error string エラーが発生した場合:エラーコード、説明などの詳細が記載されたオブジェクト。照会が成功した場合、このフィールドはゼロまたは存在しません。

ΔE₀₀と値の意味

ΔE₀₀ 商品説明 人間による知覚
< 0.5 知覚不能 色の違いは人間の目には見えない。
0.5 – 1.0 非常に低い偏差値 色の違いは実験室の条件下でのみ知覚できる。
1.0 – 2.0 軽微な逸脱 色の違いはほとんど見えず、一般的には許容範囲だ。
2.0 – 3.0 知覚可能な偏差 色の違いは直接比較すれば一目瞭然だ。
3.0 – 5.0 有意な偏差 色の差ははっきり見える。
> 5.0 強い偏差値 まるで2つの異なる色のように。
ΔE₀₀、Delta E 2000またはdE₀₀の詳細については、こちらをご覧ください。: DELTA E 2000 WIKI

⚠️ エラーコード

ステータスコード 意味
400 パラメータの欠落または無効
401 無効または見つからないAPIキー
429 月間API上限に到達
500 内部サーバーエラー

APIキーがない場合、または間違ったAPIキーが入力された場合:

{
    "api_version" => "v2",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 401,
    "error": "Unauthorized",

}

入力がない場合、または準拠しない値が入力された場合:

{
    "api_version" => "v2",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 400,
    "error": "Missing input, from or to" | "Conversion failed or input invalid",
    "user_data": {
        "username": "USER #12345",
        "used tokens": 50,
        "max tokens": 50,
        "percentage used": "100 %"
    }
}

📈 API制限と課金

各APIキーには毎月の上限が決まっています。無料はAPIキー1つにつき50トークン/月です。
API-KEYは2つまで無料で作成することができます。
アップグレードにより、さらに拡張することができます:
Basic-APIの料金プランでは、それぞれ200トークン5つのAPI-KEYを作成することができます(∑1.
Premium API の料金プランでは、10個のAPI-KEY1.
Voyager API の料金プランでは、それぞれ10,000トークン50個のAPI-KEYを作成できます(∑500,000トークン)。
特別なご要望があれば、いつでもカスタマイズしたオファーをご用意することも可能です。お気軽にお問い合わせください。

リミットに達すると

{
    "api_version" => "v2",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 429,
    "error": "Hello USER #12345, your monthly API quota of 50 requests has been used up. Please contact [email protected] to upgrade or wait for the next reset.",
    "user_data": {
        "username": "USER #12345",
        "used tokens": 50,
        "max tokens": 50,
        "percentage used": "100 %"
    }
}

🛠️ APIマネージャー

APIキーの管理(追加/削除)

総使用量とAPI関連使用量を表示

アップグレードにより毎月の限度額を増やす

新しいキーを生成する(Base64URLセーフ)

より良い差別化のためにコメントを追加

🔒 セキュリティ

すべてのパラメータはGETで送信される。

キーごとのレート制限(オプション

32バイト長のBase64URLキー

🧼 開発者向け注意事項

すべてのパラメータは大文字と小文字を区別しない

ヘックスコードは#では使用できません:有効なのはFF0000のみです。

255,0,0 または 255 0 0 for RGB

すべてのパラメータは大文字と小文字を区別しない

サポート

注意: 技術的な理由により、メーカー名によっては結果が出力されないことがあります。ヘルプが必要な場合、またはその他の理由で変換がうまくいかない場合は、info[at]qconv.comまでご連絡ください。'Basic API Service'からのお客様にはサポートを提供しております。

🆕 変更履歴

API-v2:

  • メーカー変換の際、色差もdE00形式(デルタE 2000)の色差値として出力されるようになりました。
  • 色指定(Sherwin Williams、NCS(ドイツ語)、HEXまたはRGB)がある場合、これが出力されます。
  • APIのバージョン番号とタイムスタンプも出力される
  • 入力が正しくない場合、より詳細な情報が返される

2025-08-14

API-v1:

  • ウェブサイトに統合されたAPI

2025-07-15

カラーパレットを保存するには、ログインする必要があります。

アカウントにログイン

または

アカウントを作成する

現在のカラーパレット 共有
公開か非公開か?
共有後、リンク(複数可)が続きます。

カラーパレット共有
ご希望のリンクをコピーして保存してください。

シェア

OK、リンクをコピーしておきました

カラーは新しいカラーパレットに保存され、
プロフィールの下に表示されます。
さらにカスタマイズしたり、共有することもできます。

カラーパレットを作成する

ダウンロード各種フォーマットでダウンロード

すべて削除

をクリックすると、パレットを作成し、 色見本をダウンロードすることができます。