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