首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >「WIPO 标准 ST」接口功能详解|数据鱼API

「WIPO 标准 ST」接口功能详解|数据鱼API

原创
作者头像
用户12862874
发布于 2026-11-20 21:55:42
发布于 2026-11-20 21:55:42
610
举报

接口简介

「WIPO 标准 ST」是数据鱼API平台提供的工业产权信息标准目录接口,Base 路径 /api/legal-wipo-standards-st,共 3 个端点。它对应 WIPO 工业产权信息与文献手册中的 ST 系列标准,按标准编号组织条目,每条记录包含编号、标题、分类与内容说明,支持按编号精确查找或按关键词检索。

ST 系列覆盖工业产权数据的表示与交换,例如国家及组织代码、专利文献著录项目代码、核苷酸与氨基酸序列表的 XML 结构,以及专利、商标、外观设计信息的 XML 交换模式。接口只提供标准的目录级摘要,帮助接入方确认编号对应的主题与适用范围,不包含标准正文、附件、版本历史或实施指南。

条目整理自公开条约/标准信息,以联合国、WIPO 官方文本为准。数据鱼API把检索与索引单独做成服务,便于在内部工具中嵌入标准编号查询,而不必自行维护一份易过期的对照表。

端点总览

方法

路径

说明

鉴权

GET

/api/legal-wipo-standards-st/ping

健康检查,返回版本与服务器时间

免鉴权

GET

/api/legal-wipo-standards-st/info

返回标准库名称、说明与更新日期

需要 Key

GET

/api/legal-wipo-standards-st/search

按标准编号或关键词检索条目

需要 Key

通用约定

鉴权使用统一 Key,可放在 X-API-Key 请求头或 ?api_key= 查询参数中;缺失返回 4011,无效返回 4013。响应统一为 code、msg、data。接口同时接受 GET 与 POST,POST 可用 JSON body 或表单,参数名与查询串保持一致。

错误码中,4001 表示缺少必填参数,4002 表示参数格式或取值非法,4003 表示取值不在支持列表,4004 表示查询目标未收录;4040 为路由不存在,4050 为方法不允许,5000、5001 为服务内部错误,5031、5032 表示上游依赖不可用。数据鱼API保证上游异常时返回错误码而不是伪造条目。

核心端点详解

标准库信息

GET /api/legal-wipo-standards-st/info 无参数,返回标准库的自描述信息。

参数

类型

必填

默认值

说明

无

—

—

—

该端点不接受业务参数

响应 data 含 name、description、total_standards_mock 与 last_updated。name 为 WIPO Standards (ST) API,description 指向 WIPO 工业产权信息与文献手册,total_standards_mock 为 90,last_updated 为 2026-11-11。

代码语言:javascript
复制
GET /api/legal-wipo-standards-st/info?api_key=YOUR_KEY

按编号或关键词检索

GET /api/legal-wipo-standards-st/search 支持两种筛选方式,也可组合使用。

参数

类型

必填

默认值

说明

id

string

否

—

标准编号,如 ST.3、ST.96,不区分大小写精确匹配

q

string

否

—

关键词,匹配标题或描述,不区分大小写

id 为精确匹配,ST.96 只返回该条,不会带出 ST.9;q 为子串匹配,可用于检索 XML、sequence 等主题词。两个参数同时传入时取交集。响应 data 是数组,元素含 id、title、category 与 description,category 在样本中取 Common、Patents、Data。

代码语言:javascript
复制
GET /api/legal-wipo-standards-st/search?id=ST.96&api_key=YOUR_KEY

该例返回 Recommendation for the Processing of Industrial Property Information using XML,说明其为专利、商标与外观设计信息交换提供一套 XML 模式。

数据与限制

  • total_standards_mock 为 90,表示标准库规模的口径值;当前可检索的样本为标准编号 ST.3、ST.9、ST.26、ST.96 四条。
  • ST.3 属 Common 类,主题是国家、其他实体与政府间组织代码;ST.9 与 ST.26 属 Patents 类;ST.96 属 Data 类。
  • 条目只有编号、标题、分类与描述四个字段,没有发布日期、生效版本、替代关系或全文链接。
  • 没有分页与排序参数,结果按内置顺序返回,最多覆盖当前样本集。
  • id 为完整编号的精确比较,ST.96 与 st.96 等价,但 ST96、ST 96 不会命中。
  • q 只搜索标题与描述,不搜索编号与分类,也不做同义词扩展。
  • last_updated 为数据集整理日期,不代表某条标准的发布或修订日期。

典型使用场景

  • 专利数据工程师在实现 XML 导入导出前,用编号确认应当遵循 ST.96 还是其他数据标准。
  • 知识产权管理系统的帮助页嵌入编号查询,让用户输入 ST.3 就能看到该标准的用途说明。
  • 内部标准清单需要补全标题与分类时,批量读取条目并与既有编号表比对,发现缺失项。

注意事项

  • 文档统一响应写成功 code 为 0,info 与 search 的实现返回 code 为 200;只按 0 判断会把成功响应误判为异常,建议同时接受两者。
  • id 的精确匹配对格式敏感,编号中的点号不可省略,调用前应做去空格与统一大小写处理。
  • total_standards_mock 的 90 与四条样本不是同一口径,不能据此认为 90 条都可检索。
  • 编号不存在时返回空数组而非 4004;调用方需自行区分空结果与参数错误。
  • q 不会匹配编号,查 ST.96 应使用 id;反过来,id 也不会做模糊匹配。
  • 标准会修订与替代,条目内容为摘要且可能滞后。数据鱼API不对标准的现行版本作担保。仅供参考,不构成法律意见,条目整理自公开条约/标准信息,以联合国、WIPO 官方文本为准。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 接口简介
  • 端点总览
  • 通用约定
  • 核心端点详解
    • 标准库信息
    • 按编号或关键词检索
  • 数据与限制
  • 典型使用场景
  • 注意事项
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档