提供期間 APIが拡張されました。

新しいAPI V3.0: 特別価格でAPIを入手できます。今すぐアクセスしてください。ウェブプロジェクト、プラグイン、社内ツール、SaaSアプリケーションに最適です。2025-10-21 から 2025-11-21 (23:59 CET) まで有効です。

APIパッケージと価格 X
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、およびカスタムメーカーパレットなどの異なるフォーマット間で色を変換できます。

🔑 認証

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形式（デルタE 2000）の色差値として出力されるようになりました。
  • 色指定（Sherwin Williams、NCS（ドイツ語）、HEXまたはRGB）がある場合、これが出力されます。
  • APIのバージョン番号とタイムスタンプも出力される
  • 入力が正しくない場合、より詳細な情報が返される

2025-08-14

API-V1.0:

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

2025-07-15

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

アカウントにログイン

または

アカウントを作成する

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

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

シェア

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

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

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

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

すべて削除

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

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