APIはAPIキーを使用します。
GET /api/v1/convert.php?from=hex&input=FF0000&to=ral&apikey=[APIキー]
注意:キーはBase64URLエンコード（URL互換）されており、安全です。
GET https://qconv.com/api/v1/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/v1/convert.php?from=hex &input=FF0000 &to=rgb &apikey=[APIキー]
{
"from": "hex",
"input": "FF0000",
"to": "rgb",
"result": "255 0 0",
"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/v1/convert.php?from=rgb &input=145, 25, 100 &to=behr &apikey=[APIキー]
{
"from": "rgb",
"input": "145, 25, 100",
"to": "behr",
"result": "p120-7 glitterati",
"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 %"
}
}
| フィールド | タイプ | 概要 |
|---|---|---|
| from | string | 送信出力フォーマット |
| input | string | 送信元の値 |
| to | string | 送信対象フォーマット |
| result | string | 変換結果 |
| match_percent | string/null | 一致するメーカーカラーをパーセンテージで検索する場合のカラーマッチングに関する注意事項。例'match_percent': '92.2%', メーカーカラーに変換した場合のみ出力されます。 |
| more_conversions | object | その他の利用可能なすべての並列変換を配列として |
| user_data | object | 使用されたコンバージョン数など、APIアカウントに関する情報。 |
| ステータスコード | 意味 |
|---|---|
| 400 | パラメータの欠落または無効 |
| 401 | 無効または見つからないAPIキー |
| 429 | 月間API上限に到達 |
| 500 | 内部サーバーエラー |
各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トークン）。
特別なご要望があれば、いつでもカスタマイズしたオファーをご用意することも可能です。お気軽にお問い合わせください。
リミットに達すると
{
"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'からのお客様にはサポートを提供しております。