浏览全部文档

HS 编码 API 参考

读取一个版本中的一个 HS 编码,包括名称、级别、上级和下一级编码。

概览

GET /v1/trade/hs-codes/{code}

GET /v1/trade/hs-codes/{code} 返回一个版本中的一个 HS 编码:名称、级别、上级和下一级编码。code 为 2、4 或 6 位。

版本中没有的编码返回 404 hs_code_not_found。同一个 6 位编码可能存在于一个版本而不存在于另一个版本,因为各版本之间从不相互转换。MCP 工具是 trade_get_hs_code,参数相同。

请求

2022 版中的子目 851713(智能手机),以及真实响应:

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/trade/hs-codes/851713"
编码 851713
{
  "code": "851713",
  "level": 6,
  "label": "Smartphones for wireless networks",
  "parent": "8517",
  "classification": "HS",
  "edition": "2022",
  "children": []
}

子目之下没有编码,因此 children 为空。

参数

参数位置类型必填默认值允许的取值及含义
code路径参数字符串是无2、4 或 6 位的 HS 编码,例如 85、8517 或 851713,不带点号。其他任何形式返回 400。
edition查询参数字符串否20222007、2012、2017 或 2022。其他任何值返回 400。

响应

响应包含以下字段。

字段含义
code编码。
level2 表示章,4 表示品目,6 表示子目。
label该版本用语中的编码名称。
parent上一级编码。章为 null。
classificationHS。
edition版本。
children下一级编码,每个含 code、level、label 和 parent。子目为空。

更多示例

版本中没有的编码

编码 851713 是 2022 版新增的。2017 版没有它,所以请求返回 404,且免费:

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/trade/hs-codes/851713?edition=2017"
2017 版中的编码 851713
{
  "type": "https://narwhalapi.com/problems/hs-code-not-found",
  "title": "HS code not found",
  "status": 404,
  "detail": "HS 2017 has no code 851713.",
  "code": "hs_code_not_found",
  "request_id": "d8c40c41-aeaf-4b83-a315-c855697eafc3"
}

来源

该路由存有的是编码而不是贸易数据,因此不适用任何来源。

币种

该路由不返回数值,因此不适用货币。

分页

该路由没有分页。所有下级编码在一个响应中返回。

价格

找到编码的每个请求算一次调用,每 1,000 次调用 $2。找不到的编码和其他所有错误都免费。

错误

这些错误采用通用的错误响应格式,并带有 request_id。缺少或无效的密钥(401)、余额低于一次调用的价格(402)以及每分钟请求过多(429)是所有路由共有的账户类错误:见 API 错误码与额度。

状态代码触发时机
400invalid_querycode 不是 2、4 或 6 位,或 edition 不是 2007、2012、2017 或 2022。
404hs_code_not_found该版本没有这个编码,例如 HS 2017 has no code 851713.

API 错误码与额度 · 贸易数据 API 参考 · 贸易国家

此页面对你有帮助吗?