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

✕
API-V1 API-V2 - 新
< 致 API 管理员

目录

🔑 认证

通过 URL 参数验证

🔗 终点

📥查询参数

支持的格式

✅ 查询示例

📦 响应结构

⚠️ 错误代码

📈 API 限制和计费

🛠️ 应用程序接口管理器

🔒 安全

🧼 开发人员注意事项

🆕 更改日志

V2 新 – qConv.com 颜色转换器 - API 文档

利用 qConv API，您可以在不同格式之间转换颜色，包括 RGB、HEX、CMYK、PANTONE®、RAL、HKS、NCS 和自定义制造商调色板。

🔑 认证

应用程序接口使用 API 密钥，您可以通过客户专区对其进行管理。

通过 URL 参数验证

GET /api/v2/convert.php?from=hex&input=FF0000&to=ral&apikey=[您的应用程序接口密钥]

注意：密钥采用 Base64URL 编码（与 URL 兼容），并且是安全的。

🔗 终点

GET https://qconv.com/api/v2/convert.php

📥 查询参数

参数 类型 需要 说明
from string ✅ 是 颜色的来源格式，如 rgb、ral 或制造商名称，如 behr
input string ✅ 是 输入值，例如：<代码>FF0000
to string ✅ 是 颜色的目标格式，如十六进制、cmyk 或制造商名称，如 Caparol 颜色
apikey string ✅ 是 您的个人和秘密 API 密钥

支持的格式

颜色格式

rgb hex cmyk pantone ral hks ncs sw

制造商颜色

您在以下链接下的制造商页面上找到的所有制造商代码也是有效值。

https://qconv.com/zh/制造商

在制造商网站的左侧栏中查找 API 代码。或查找以下符号:

✅ 查询示例

六角形 至 灰度

GET /api/v2/convert.php?from=hex&input=FF0000&to=rgb&apikey=[您的应用程序接口密钥]

请回答：

{
    "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 %"
    }
}

灰度 至 制造商颜色 BEHR

GET /api/v2/convert.php?from=rgb&input=145, 25, 100&to=behr&apikey=[您的应用程序接口密钥]

请回答：

{
    "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 版本，如 'v2
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 Sherwin Williams 的颜色名称、NCS（德国）、HEX（如果有）、RGB（如果有）。
deltaE00 string/null 颜色之间的差异为 DeltaE2000 值 (ΔE₀₀)。有关 DeltaE 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 强烈偏差 就像两种不同的颜色一样。
有关 Δ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 密钥都有固定的每月限额。免费是每个 API 密钥每月 50 个令牌。最多可免费创建 2 个 API-KEY 。

可通过升级扩展：
使用 Basic-API 费率，您可以创建 5 个 API-KEY ，每个 200 个令牌（∑ 1.
使用 Premium API关税，您可以创建 10 个 API-KEYs ，每个200 个代币（∑ 1.
使用 Voyager API 收费标准，您可以创建 50 个 API-KEYs 每个 10,000 个代币（∑ 10,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 相关使用量

通过升级提高每月限额

生成新密钥（Base64URL-safe）

为更好地区分添加评论

🔒 安全

所有参数均通过 GET 发送

每个按键的速率限制可选

32 字节长 Base64URL 密钥

🧼 开发人员注意事项

所有参数均大小写敏感

不能使用 # 的十六进制编码：只有 FF0000 有效

255,0,0 或 255 0 0 用于 RGB

所有参数均大小写敏感

支持

注意：由于技术原因，某些制造商名称可能无法输出结果。如果您需要帮助或因其他原因导致转换失败，请通过 info[at]qconv.com 联系我们。我们为'基本 API 服务'的客户提供支持。

🆕 更改日志

API-v2:

  • 转换到制造商时，色差现在也以 dE00 格式（Delta E 2000）的色差值输出
  • 如果有颜色名称（Sherwin Williams、NCS（德国）、HEX 或 RGB），则输出该名称
  • 还会输出应用程序接口版本号和时间戳
  • 如果输入不正确，将返回更多信息

2025-08-14

API-v1:

  • 网站集成了应用程序接口

2025-07-15

您必须登录后才能保存调色板。

登录您的账户

或

创建账户

分享当前的调色板
是公开的还是私人的？
分享后会有链接。

取消 分享

共享调色板
请复制并保存所需的链接。

分享

好的，我复制了链接

您的颜色会保存在一个新的调色板中。
在您的个人档案中查看它们。
您可以进一步自定义并共享它们。

显示调色板
关闭

创建调色板

下载以各种格式下载

全部删除

点击 可以创建调色板并下载 色板。

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