开发者门户

开放接口 · 标准接入

备案、溯源、托管三大能力以 REST API 开放，签名鉴权、限流配额与接入流程均已定义；沙箱环境规划中。

REST · JSONHMAC-SHA256 签名演示环境 · 模拟 Key

接口总览

三大核心 API

下列示例为演示环境请求 / 响应示意，非真实可用凭据；字段以 openapi.yaml 为准。

POST/api/v1/filing备案号生成

提交备案六字段，返回唯一备案号与存证信息。

请求 Request

{
  "author": "某某（示例）",
  "era": "当代 · 2025年",
  "size": "138 × 68 cm",
  "material": "纸本设色",
  "condition": "良好 · 无修补",
  "price": 68000
}

响应 Response

{
  "filingNo": "AS-2026-000123",
  "status": "SUBMITTED",
  "chain": "存证链选型中",
  "hash": "9f2c7ab4…b9d2e4",
  "timestamp": "2026-01-12T09:24:33+08:00"
}

GET/api/v1/provenance/{filingNo}溯源查询

按备案号查询来源档案与流转记录，留存 5 年。

请求 Request

GET /api/v1/provenance/AS-2026-000123
Accept: application/json

响应 Response

{
  "filingNo": "AS-2026-000123",
  "author": "某某（示例）",
  "records": [
    { "event": "SUBMITTED", "at": "2026-01-12" },
    { "event": "TRANSFER",  "at": "2026-02-03" }
  ],
  "retentionYears": 5
}

POST/api/v1/escrow资金 / 作品托管

创建担保类托管单并返回托管状态；资金由持牌支付机构托管。

请求 Request

{
  "filingNo": "AS-2026-000123",
  "type": "GUARANTEE",
  "amount": 68000,
  "buyerId": "b_9001",
  "sellerId": "s_2001"
}

响应 Response

{
  "escrowId": "ES-2026-77A1",
  "state": "FROZEN",
  "clearing": "LICENSED_PSP_NO_SECOND_CLEARING",
  "amount": 68000
}

存证链口径

响应示例中的 chain 字段标注为「存证链选型中」：存证链尚未选定，链名与司法出证能力待定，不构成既成事实。

资金由持牌支付机构托管，不二清：艺栈网不触碰、不沉淀交易资金，不做二次清算。

快速开始

三步接入

STEP 1

领取演示 Key

沙箱环境使用演示 Key，无需真实资质（规划中）

STEP 2

按签名算法发起请求

四个请求头 + HMAC-SHA256 签名

STEP 3

解析统一错误信封

错误响应统一返回 code / message / requestId

查看认证签名 →在线申请规划中

限流配额

三档服务等级摘要

QPS 与月度调用量
TRIAL	10 QPS · 1,000 次 / 月 · 试用 / 联调
STANDARD	50 QPS · 10,000 次 / 月 · 中小平台正式接入
ENTERPRISE	200 QPS · 配额自定 · 大型平台 / 高并发

演示环境

本站为演示环境，示例 Key、接口地址与接口响应均为示意，非真实可用凭据。完整字典见错误码页。

查看服务与收费标准 →预约接入演示 · 提交意向 →