HS 编码 API 参考
读取一个版本中的一个 HS 编码,包括名称、级别、上级和下一级编码。
概览
GET /
GET / 返回一个版本中的一个 HS 编码:名称、级别、上级和下一级编码。code 为 2、4 或 6 位。
版本中没有的编码返回 404 hs_。同一个 6 位编码可能存在于一个版本而不存在于另一个版本,因为各版本之间从不相互转换。MCP 工具是 trade_,参数相同。
请求
2022 版中的子目 851713(智能手机),以及真实响应:
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/trade/hs-codes/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 | 查询参数 | 字符串 | 否 | 2022 | 2007、2012、2017 或 2022。其他任何值返回 400。 |
响应
响应包含以下字段。
| 字段 | 含义 |
|---|---|
code | 编码。 |
level | 2 表示章,4 表示品目,6 表示子目。 |
label | 该版本用语中的编码名称。 |
parent | 上一级编码。章为 null。 |
classification | HS。 |
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"{
"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_。缺少或无效的密钥(401)、余额低于一次调用的价格(402)以及每分钟请求过多(429)是所有路由共有的账户类错误:见 API 错误码与额度。
| 状态 | 代码 | 触发时机 |
|---|---|---|
400 | invalid_query | code 不是 2、4 或 6 位,或 edition 不是 2007、2012、2017 或 2022。 |
404 | hs_code_not_found | 该版本没有这个编码,例如 HS 2017 has no code 851713. |
此页面对你有帮助吗?