简 介
Base URL：
演示环境：
https://api.y45.cn/v1演示环境：
https://api.y45.cn/v1
花印集开放平台以 RESTful 风格提供全链路 API，覆盖素材检索、在线下单、授权查询、账户管理等核心能力。所有下载图均嵌入唯一暗水印标识，形成完整版权溯源闭环。
鉴 权 方 式
所有 API 调用需在请求头中携带 AppKey 和 AppSecret，开发者需先完成入驻审核，创建应用后获取。
GET /v1/materials HTTP/1.1
Host: api.y45.cn
X-App-Key: DEV_APP_0001
X-App-Secret: sk_xxxxxxxxxx
Content-Type: application/json频 率 限 制
| 应用等级 | QPS 限制 | 日调用量 |
|---|---|---|
| 普通开发者 | 10 次/秒 | 10,000 次/日 |
| 认证企业开发者 | 50 次/秒 | 100,000 次/日 |
| 战略合作伙伴 | 不限 | 不限 |
素 材 接 口
GET
/v1/materials
可用
分页获取素材列表，仅返回已审核通过的素材。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | int | 否 | 页码，默认 1 |
| size | int | 否 | 每页数量，默认 10，最大 50 |
| theme | string | 否 | 主题分类筛选 |
| keyword | string | 否 | 关键词搜索 |
响应示例
{
"code": 0,
"msg": "success",
"data": {
"list": [
{
"id": 1,
"title": "春日玫瑰主题",
"theme": "玫瑰",
"price": 29.90,
"preview_url": "https://cos.../rose_1.jpg?watermark=1",
"created_at": "2026-08-10 10:00:00"
}
],
"total": 100,
"page": 1,
"size": 10
}
}
GET
/v1/materials/:id
可用
获取单个素材的详细信息，包含所有明水印预览图地址。
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | int | 素材 ID |
响应示例
{
"code": 0,
"data": {
"id": 1,
"title": "春日玫瑰主题",
"theme": "玫瑰",
"price": 29.90,
"description": "春日玫瑰主题素材，3 张同色系高清图",
"cover": "https://cos.../rose_1.jpg?watermark=1",
"previews": [
"https://cos.../rose_1.jpg?watermark=1",
"https://cos.../rose_2.jpg?watermark=1",
"https://cos.../rose_3.jpg?watermark=1"
],
"creator_id": 2,
"created_at": "2026-08-10 10:00:00"
}
}授 权 接 口
POST
/v1/auth/query
Beta
上传图片提取暗水印，查询授权记录。适用于平台合规巡检、维权取证等场景。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image | file | 是 | 待检测图片 |
| wm_code | string | 否 | 已知水印码时可直接查询 |
响应说明
返回授权主体（脱敏）、授权有效期、素材信息等。未匹配到授权时返回 found: false。
订 单 接 口
POST
/v1/orders
Beta
开发者批量采购素材时调用，必须传入授权主体信息。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| material_id | int | 是 | 素材 ID |
| auth_subject | string | 是 | 授权主体（公司全称/产品名） |
| auth_usage | string | 是 | 使用场景 |
| app_id | int | 是 | 关联的应用 ID |
GET
/v1/orders/:order_no/download
Beta
下载已支付订单的素材原图。服务端会将订单号、授权主体、应用 ID 以暗水印形式嵌入原图后返回。
注意：返回的图片流已嵌入暗水印，下载后请妥善保管，不得再次分发。
ISV 应 用 接 口
适用场景：ISV 应用（
app_type=2）可引导用户 / 创作者完成 OAuth2 授权，经其同意后拉取账号数据：
用户信息、购买记录、以及创作者的图库（公开作品 & 私有作品）。以下接口均需在请求头携带 Authorization: Bearer <access_token>。
GET
open.y45.cn/authorize
OAuth2 授权
引导用户/创作者跳转授权页，同意后回调 redirect_uri 并携带 code，再用 code 换取 access_token。
https://open.y45.cn/authorize
?client_id=DEV_APP_0001
&redirect_uri=https://your-app.com/callback
&scope=profile order read upload write
&state=xyz123Scope 说明：read=公开素材 · upload=访问该创作者图库(含私有) · write=素材管理 · order=购买记录 · profile=基本资料
GET
/v1/isv/user/info
scope: profile
获取当前已授权账号的资料（昵称、头像、角色：用户/创作者/开发者、所在地等）。
GET /v1/isv/user/info HTTP/1.1
Host: api.y45.cn
Authorization: Bearer <access_token>
GET
/v1/isv/user/orders
scope: order
拉取已授权用户/创作者名下的购买记录（含订单号、素材、授权主体、金额、状态）。
GET /v1/isv/user/orders HTTP/1.1
Host: api.y45.cn
Authorization: Bearer <access_token>
GET
/v1/creators/:creator_id/materials
scope: read
获取指定创作者图库中的公开作品（仅已审核上架）。
GET /v1/creators/101/materials HTTP/1.1
Host: api.y45.cn
GET
/v1/creators/:creator_id/materials?visibility=private
scope: upload · 需创作者本人授权
读取该创作者图库中的私有作品（草稿/私密作品）。仅当授权账号即该创作者本人、且授予 upload 权限时可访问。
GET /v1/creators/101/materials?visibility=private HTTP/1.1
Host: api.y45.cn
Authorization: Bearer <access_token>注意：授权记录管理在
user.y45.cn/oauth，用户可随时撤销 ISV 权限；调用越权数据将返回 403。水 印 机 制
明水印（预览用）
所有预览图通过 COS 图片处理接口嵌入明水印，包含商品 ID 和创作者 ID，防止现场截图盗用。
?watermark=1&text=M{material_id}_C{creator_id}
&fontsize=14&fill=white&dissolve=70&gravity=northwest暗水印（下载用）
下载原图时，服务端使用 PHP 隐写库（最低有效位 LSB 算法）将以下信息嵌入图片像素最低位：
order_no- 订单号auth_subject- 授权主体dev_app_id- 开发者应用 IDtimestamp- 授权时间戳
暗水印不可见、不影响画质，可通过授权查询接口提取验证，形成完整版权溯源闭环。
错 误 码 列 表
| 错误码 | HTTP 状态 | 说明 |
|---|---|---|
| 0 | 200 | 成功 |
| 10001 | 401 | AppKey 或 AppSecret 无效 |
| 10002 | 403 | 应用未通过审核 |
| 10003 | 403 | 保证金不足，请先充值 |
| 20001 | 404 | 素材不存在或已下架 |
| 30001 | 400 | 授权主体信息不完整 |
| 40001 | 429 | 请求频率超限 |
| 50000 | 500 | 服务器内部错误 |
