HSコードAPIリファレンス
ある版の1つのHSコードを、その名称、レベル、親コード、1つ下のレベルのコードとともに読み取ります。
概要
GET /
GET / は、ある版の1つのHSコードを返します。名称、レベル、親コード、1つ下のレベルのコードです。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 | 1つ上のレベルのコード。類では null。 |
classification | HS。 |
edition | 版。 |
children | 1つ下のレベルのコード。それぞれ 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回の回答で返ります。
価格
コードが見つかったリクエストは1回の呼び出しで、1,000回あたり$2です。コードが見つからない場合と、その他すべてのエラーは無料です。
エラー
これらのエラーは、request_ を含む共通のエラー形式で返されます。キーがない、または無効な場合(401)、残高が呼び出しの料金に満たない場合(402)、1分あたりのリクエストが多すぎる場合(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. |
このページは役に立ちましたか?