APIはAPIキーを使用します。
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 %" } }
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₀₀ | 商品説明 | 人間による知覚 |
---|---|---|
< 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キー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" => "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関連使用量を表示
アップグレードにより毎月の限度額を増やす
新しいキーを生成する(Base64URLセーフ)
より良い差別化のためにコメントを追加
すべてのパラメータはGET
で送信される。
キーごとのレート制限(オプション
32バイト長のBase64URLキー
すべてのパラメータは大文字と小文字を区別しない。
ヘックスコードは#では使用できません:有効なのはFF0000
のみです。
255,0,0
または 255 0 0
for RGB
すべてのパラメータは大文字と小文字を区別しない。
注意: 技術的な理由により、メーカー名によっては結果が出力されないことがあります。ヘルプが必要な場合、またはその他の理由で変換がうまくいかない場合は、info[at]qconv.comまでご連絡ください。'Basic API Service'からのお客様にはサポートを提供しております。
API-v2:
2025-08-14
API-v1:
2025-07-15