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 | 경로 | 문자열 | 예 | 없음 | 점 없이 85, 8517, 851713처럼 2자리, 4자리 또는 6자리 HS 코드. 다른 형식은 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회이며 1,000회 호출당 $2입니다. 찾지 못한 코드와 그 밖의 모든 오류는 무료입니다.
오류
이 오류는 request_가 포함된 공통 problem 형식을 사용합니다. 키가 없거나 유효하지 않은 경우(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. |
이 페이지가 도움이 되었나요?