海关类目查询API
按 10 位海关编码查询所属税则类目与索引目录(章/目/子目层级)。返回 CategoryId、CategoryName、List(编码→名称映射)、Count。通用接口,购买税则/归类能力附赠。本接口无分页。
已开放
调用入口:POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域(必填) | trade |
| type | string | 数据类型(必填) | hs_code_map |
| query | string | 10 位海关编码;与 filters.code 二选一 | 0101290090 |
| filters | object | 结构化过滤条件,见下方「常用 filters」 | — |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| code | string | 10 位海关编码(也可用 query) | 0101290090 |
返回字段(hits[])
| 字段 | 类型 | 说明 |
|---|---|---|
| CategoryId | integer | 类目编号 |
| CategoryName | string | 类目名称 |
| List | object | 索引目录(编码→名称) |
| Count | integer | 目录内税则项目合计数 |
| source | string | 来源标识 |
| disclaimer | string | 数据口径说明 |
curl 请求示例
curl -sS -X POST https://data.devnors.com/v1/data/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain":"trade", "type":"hs_code_map", "query":"0101290090", "filters":{ "code":"0101290090" } }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。