风险结论 · advice

POST /v1/advice

对候选品牌给出结构化的「规避 / 谨慎 / 可上」结论及判定理由 —— 与 One1 应用同一套规则层。

• 消耗:20 API 点
• 可用档位:全部(含免费版)
• 检索范围:固定比对美国 USPTO 库,不接收 country 参数

请求参数

参数	类型	必填	说明
q	string	是	候选品牌名 / 商标文字
nice	string	否	尼斯分类号(可选)
live	0/1	否	传 1 只看有效在先标(可选)

请求示例

cURL

curl -X POST "https://one1.cn/v1/advice" \
  -H "Authorization: Bearer one1_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"q":"NIKE","nice":"25"}'

Python

import requests
r = requests.post(
    "https://one1.cn/v1/advice",
    json={"q": "NIKE", "nice": "25"},
    headers={"Authorization": "Bearer one1_live_xxxxxxxx"},
)
print(r.json())

响应示例

{
  "advice": {
    "tier": "规避",
    "reason": "存在高相似度且类目重合的有效在册商标",
    "actions": ["更换品牌名", "咨询专业代理"],
    "disclaimer": "风险提示 · 非法律意见",
    "signals": { "…": "…" }
  },
  "coverage": { "scope": "full", "warning": "", "clearance_ok": true },
  "request_id": "3f9a1c2b7d4e8f01",
  "timestamp": "2026-10-10T07:20:01Z"
}

响应字段

字段	类型	说明
advice.tier	string	结论档位:规避 / 谨慎 / 可上
advice.reason	string	判定理由
advice.actions	array	建议动作
advice.disclaimer	string	免责声明
advice.signals	object	判定依据信号
advice	null	非品牌/空输入时为 null
coverage.scope	string	美国 USPTO 文本库的覆盖口径(本端点固定比对美国库);coverage.clearance_ok 为 false 时「可上」不可当作可注册
coverage.warning	string	覆盖警示文案(空串 = 无警示),请原样展示给终端用户;文案来自覆盖度配置,可能提及该库的数据截止时间
coverage.clearance_ok	bool	是否可把「无匹配」当作可注册的参考依据;仅 coverage.scope 为 full 时为 true
request_id	string	本次请求的追踪 ID,与响应头 X-Request-Id 同值(调用方自带该头则原样回显);排障时请提供
timestamp	string	服务端响应时间,UTC ISO 8601 带 Z(如 2026-10-10T07:20:01Z);不代表数据新鲜度