Dear color lovers – together, we’ll have a more colorful future. Support us on

✕
API-V1.0 API-V2.0 API-V3.0 新規
< APIマネージャーへ

内容

🔑 認証

URLパラメータによる認証

🔗 終点

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

対応フォーマット

✅ お問い合わせ例

📦 応答体制

⚠️ エラーコード

📈 API制限と課金

🛠️ APIマネージャー

🔒 セキュリティ

🧼 開発者向け注意事項

🆕 変更履歴

V3.0 – qConv.com コンバータ - API ドキュメント

Convert-API V3.0 Color-API V3.0 新規

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

🔑 認証

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

URLパラメータによる認証

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

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

🔗 終点

GET https://qconv.com/api/v3.0/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/v3.0/convert.php?from=hex&input=FF0000&to=rgb&apikey=[APIキー]

答えてくれ：

{
    "api_version" => "v3.0",
    "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": "137",
        "ral":     "1028",
        "hks":     "5",
        "rgb":     "255 165 0",
        "hex":     "#FFA500",
        "cmyk":    "0 35 100 0",
        "sw":      "6905",
        "ncs":     "S0580-Y30R",
        "hsl":     "38.82 1 0.5",
        "lab":     "74.93 23.94 78.96"
    },
    "user_data": {
        "username": "USER #12345",
        "used tokens": 1,
        "max tokens": 50,
        "percentage used": "2 %"
    }
}

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

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

答えてくれ：

{
    "api_version" => "v3.0",
    "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",
        "hsl": "322.5 0.71 0.33",
        "lab": "33.21 53.97 -13.06"
    },
    "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" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 401,
    "error": "Unauthorized",

}

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

{
    "api_version" => "v3.0",
    "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-KEYを1.
Voyager API の料金プランでは、それぞれ10,000トークンで50個のAPI-KEYを作成できます（∑500,000トークン）。
特別なご要望があれば、いつでもカスタマイズしたオファーをご用意することも可能です。お気軽にお問い合わせください。

リミットに達すると

{
    "api_version" => "v3.0",
    "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

185Cと185 CはPANTONEのために働く。

サポート

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

🆕 変更履歴

API-V3.0:

  • NEW:透過色について、補色、明色、暗色、暖色、寒色などのそれぞれの関連色を取得できるようになりました。この目的のために/api/color.phpを作成しました。
  • LABとHSLカラーが答えに統合されました。

  • NEW：'used_tokens'。

  • NEW:'max_tokens'オブジェクトuser_dataでは、識別子'max tokens'をアンダースコアで標準化しました。

  • NEW:'percentage_used'
    オブジェクトuser_dataでは、識別子'percentage used'をアンダースコアで標準化しました。

2025-10-21

API-V2.0:

  • 色差は、メーカー変換時にdE00形式（Delta E 2000）の色差値としても出力されるようになりました。
  • 色指定（Sherwin Williams、NCS（ドイツ語）、HEXまたはRGB）がある場合、これが出力されます。
  • APIのバージョン番号とタイムスタンプも出力される
  • 誤入力の場合は、その理由についての詳細な情報が提供されます。

2025-08-14

API-V1.0:

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

2025-07-15

カラーパレットを保存するには、登録が必要です。

ゲストでもカラーコレクターで色をまとめ、ダウンロードできます。パレットを永続的に保存し、パレットごとの色を管理するには、無料でqConv Startを有効にしてください。

アカウントにログインする

または

アカウントの作成

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

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

シェア

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

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

カラーパレットの作成

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

すべて削除

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

Gastzugang

Gastzugang

ゲストアクセス – qConv Startプロフィールはまだありません 基本機能はゲスト利用枠で使用できます。 無料アカウントを作成するとqConv Startが有効になります。その後、カラーパレットや画像をプロフィールに保存できます。
パレットの保存：無料プロフィールが必要ゲストカラーコレクターは最大5色

© 2019-2026 - Designed by frag-bobby.de