文档 / 快速开始

快速开始

三步跑通第一次检索；网页端无需任何配置。

1. 注册并创建 API Key

在注册页创建账号，登录后进入控制台 · API Keys 生成 Key。Key 仅创建时明文显示一次。

2. 调用检索接口

curlsearch.sh

curl -X POST https://api.tmglobal.example/api/trademark/search \
  -H "Authorization: Bearer $TM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mark":"HUAWEI","mode":"smart","page":1,"size":10}'

3. 读取结果

jsonresponse.json

{
  "code": 200,
  "data": {
    "totalHits": 152,
    "totalPages": 8,
    "currentPage": 1,
    "hits": [
      { "mark": "HUAWEI", "appNum": "501734182", "ipOffice": "BR",
        "niceCode": "12", "statusCategory": "LIVE", "score": 10500 }
    ]
  }
}

相似度：接口返回的 score 是原始分；业务展示请按「查询词 vs 商标文本」计算 0–100 相似度（与网页端一致）。

← 文档首页 REST API →