新機能: APIパッケージが利用可能になりました。


複数のAPIキーを作成し、毎月のトークンクォータを管理し、qConvをアプリケーションに柔軟に統合することができます。

2025-08-15:全パッケージを紹介価格でご利用いただけます。

今すぐ見る X

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

✕

qConv.com カラーコンバータ - API ドキュメント

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

🔑 認証

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

URLパラメータによる認証

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/en/会

メーカーのウェブサイトの左側の列にある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 %"
    }
}

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

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キーには毎月の上限が決まっています。無料は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キーの管理（追加/削除）

総使用量とAPI関連使用量を表示

アップグレードにより毎月の限度額を増やす

新しいキーを生成する（Base64URLセーフ）

より良い差別化のためにコメントを追加

🔒 セキュリティ

すべてのパラメータはGETで送信される。

キーごとのレート制限（オプション

32バイト長のBase64URLキー

🧼 開発者向け注意事項

すべてのパラメータは大文字と小文字を区別しない。

ヘックスコードは#では使用できません：有効なのはFF0000のみです。

255,0,0 または 255 0 0 for RGB

すべてのパラメータは大文字と小文字を区別しない。

サポート

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

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

アカウントにログイン

または

アカウントを作成する

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

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

シェア

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

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

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

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

すべて削除

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

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