Chinese Color AtlasCATHYCOLOR API
161 种传统色 · 服务端接入
support@chinesecoloratlas.com

把中国传统色接入你的产品

通过 API 匹配颜色、搜索色名，让你的网站、应用和设计工具使用中国传统色。目前支持 161 种颜色。

颜色匹配 · 色名搜索

按颜色匹配，也能按名称查找。

输入颜色，查找相近的中国传统色；也可以按名称搜索 161 种颜色。你的产品通过自己的后端连接 API。

邮件联系 API 支持 ↗
—正在读取意向票数…
联系 API 支持 ↗

新 API 销售和新客户账户开通目前暂停。现有客户可继续使用当前 API 和有效密钥；续费与支持服务继续。

API 功能

从一个颜色，找到相近的中国传统色

输入颜色，查找相近的传统色；也可以按色名搜索。你的后端还可查询当前用量和色库信息。API 包含 161 种颜色，不含完整色彩图谱，也不提供整库下载。

POST/v1/match

颜色匹配

将输入颜色与色库比对，查找相近的中国传统色。

GET/v1/search

按名称搜索

按名称搜索色库中的颜色。

GET/v1/usage

查看用量

查看本月已匹配的颜色数量和搜索次数，用量按 UTC 时间计算。

GET/v1/library

查看色库信息

查看当前色库版本及收录的颜色数量。

现有 API 用量

现有客户的用量上限

颜色匹配

2,000 个输入颜色

每个 UTC 公历月上限；每个输入颜色计一次。

色名搜索

1,000 次搜索

每个 UTC 公历月上限。

额度重置

按 UTC 月重置 · 不结转

每个 UTC 月月初重置，与账单日期无关。首个周期可能不足整月。达到上限后拒绝请求，不另收用量费。

现有客户服务

现有 API 服务继续运行

现有客户可继续使用 API 和当前有效密钥。新 API 销售及新客户账户开通目前暂停。

现有有效 API 密钥可继续使用。不要向支持人员发送私钥或 API 密钥。

  1. 01

    继续使用现有密钥

    照常从你的服务端调用 API；现有 API 密钥继续有效。

  2. 02

    查看用量与指南

    使用接入指南查看当前用量，并妥善保管 API 密钥。

  3. 03

    联系 API 支持

    现有客户支持与续费继续。请勿通过邮件发送私钥或 API 密钥。

服务状态与用量

新销售和新账户开通暂停。

目前暂停接受新的 API 销售和开通新客户账户。现有客户可继续使用 API 和有效密钥，续费与支持服务继续。用量额度在每个 UTC 公历月月初重置，未用额度不结转。此 Beta 服务不提供服务等级协议（SLA）。

  • API 只能由你的服务端调用，不支持浏览器直接请求。
  • 仅含 161 种颜色，不含完整色彩图谱，也不提供整库下载。
  • 某项额度达到上限后，后续同类计量请求会被拒绝；不会自动超额计费或加购。