HSK 코드 조회 API

한국 HS 코드 6자리를 기준으로 하위 HSK 코드 목록을 조회합니다.

  • REST 인증 API로 발급받은 accessToken 쿠키가 필요합니다.
  • hsCode query parameter는 숫자 6자리만 허용합니다.
  • 응답의 hsCodeList에는 조회된 HSK 코드 후보 목록이 포함됩니다.
  • 조회 조건에 해당하는 HSK 코드가 없으면 hsCodeList는 빈 배열로 반환됩니다.
  • 각 항목의 name, nameOrigin은 전체 계층 경로를 포함한 품명입니다.
  • details는 HS 코드 계층 구조를 순서대로 제공하며, 각 계층의 hsCode, name, nameOrigin을 포함합니다.

API Endpoint

GET/v1/rest/hsk-codes
Cookie Auth RequiredResponse: */*

API 한눈에 보기

구현 전에 확인할 요청/응답 규모와 코드값 힌트입니다.

Samples included

Request Fields

1

Required Fields

1

Response Fields

12

Available Code Samples

cURL / fetch / Response

• 인증 후 Cookie: accessToken=발급받은_토큰값 헤더가 필요합니다.

구현 체크리스트 (Implementation Checklist)

✓요청 헤더에 Cookie: accessToken=발급받은_토큰값을 포함합니다.

✓Content-Type과 lang 헤더를 실제 운영 환경에서도 동일하게 전달합니다.

운영 확인 항목

!요청 시각, path, HTTP status, errorCode를 로그에 보관합니다.

!개인정보 필드는 로그와 실패 알림에서 완벽히 마스킹 처리합니다.

!4xx 에러는 요청 데이터 자가 보정, 5xx 에러는 임시 지수 백오프 적용 대상으로 삼습니다.

Query Parameters

1 fields1 required

hsCode

required
string

조회할 한국 HS 코드 6자리 숫자

example300212

Response

4 fields1 nested

success

boolean

API 성공 여부

exampletrue

message

string

전달 메세지

exampleAPI가 정상 처리되었습니다

errorCode

number

int32

에러 코드

example0

data

OBJECT하위 1개

HSK 코드 조회 API Response Data

example{}

이 필드는 객체 구조입니다. 하위 필드는 섹션에서 확인합니다.

Response

/

data

data 하위 필드

1 fields

HSK 코드 조회 API Response Data

OBJECT

hsCodeList

ARRAY하위 4개

HSK 코드 목록

example[]

이 필드는 배열 구조입니다. 하위 필드는 섹션에서 확인합니다.

Response

/

data.hsCodeList[]

hsCodeList[] 하위 필드

4 fields

HSK 코드 목록

ARRAY

hsCode

string

HS CODE

example3002122000

name

string

HS CODE 품명

example면역혈청

nameOrigin

string

HS CODE 원문 품명

exampleAntisera

details

ARRAY하위 3개

HS CODE 계층 구조 리스트

example[]

이 필드는 배열 구조입니다. 하위 필드는 섹션에서 확인합니다.

Response

/

data.hsCodeList[].details[]

details[] 하위 필드

3 fields

HS CODE 계층 구조 리스트

ARRAY

hsCode

string

HS CODE

example300212

name

string

HS CODE 계층 품명

example면역혈청과 그 밖의 혈액 분획물

nameOrigin

string

HS CODE 계층 품명 원문

exampleAntisera and other blood fractions

예시 코드 및 샘플

같은 요청을 cURL, JavaScript fetch, JSON 샘플로 확인할 수 있습니다.

curl -X GET "$BASE_URL/v1/rest/hsk-codes?hsCode=300212" \
  -H "lang: ko" \
  -H "Cookie: accessToken=발급받은_토큰값"
const response = await fetch(`${BASE_URL}/v1/rest/hsk-codes`, {
  "method": "GET",
  "headers": {
    "lang": "ko",
    "Cookie": "accessToken=발급받은_토큰값"
  }
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(`ASAP API error: ${response.status} ${error.message ?? ''}`);
}

const data = await response.json();
{
  "success": true,
  "message": "HSK 코드가 정상적으로 조회되었습니다.",
  "errorCode": 0,
  "data": {
    "hsCodeList": [
      {
        "hsCode": "3002122000",
        "name": "사람의 피, 치료용ㆍ예방용ㆍ진단용으로 조제한 동물의 피, 면역혈청ㆍ그 밖의 혈액 분획물과 면역물품(생물공학적 방법에 따라 변성되거나 얻어진 것인지에 상관없다), 백신ㆍ독소ㆍ미생물 배양체(효모는 제외한다)와 이와 유사한 물품, 세포 배양체(변성된 것인지에 상관없다) (3002) --> 면역혈청, 그 밖의 혈액 분획물과 면역물품(생물공학적 방법에 따라 변성되거나 얻어진 것인지에 상관없다) (3002.1) --> 면역혈청과 그 밖의 혈액 분획물 (3002.12) --> 면역혈청 (3002.12-2000)",
        "nameOrigin": "Human blood; animal blood prepared for therapeutic, prophylactic or diagnostic uses; antisera, other blood fractions and immunological products, whether or not modified or obtained by means of biotechnological processes; vaccines, toxins, cultures of micro-organisms(excluding yeasts) and similar products; cell cultures, whether or not modified. (3002) --> Antisera, other blood fractions and immunological products, whether or not modified or obtained by means of biotechnological processes : (3002.1) --> Antisera and other blood fractions (3002.12) --> Antisera (3002.12-2000)",
        "details": [
          {
            "hsCode": "3002",
            "name": "사람의 피, 치료용ㆍ예방용ㆍ진단용으로 조제한 동물의 피, 면역혈청ㆍ그 밖의 혈액 분획물과 면역물품(생물공학적 방법에 따라 변성되거나 얻어진 것인지에 상관없다), 백신ㆍ독소ㆍ미생물 배양체(효모는 제외한다)와 이와 유사한 물품, 세포 배양체(변성된 것인지에 상관없다)",
            "nameOrigin": "Human blood; animal blood prepared for therapeutic, prophylactic or diagnostic uses; antisera, other blood fractions and immunological products, whether or not modified or obtained by means of biotechnological processes; vaccines, toxins, cultures of micro-organisms(excluding yeasts) and similar products; cell cultures, whether or not modified."
          },
          {
            "hsCode": "30021",
            "name": "면역혈청, 그 밖의 혈액 분획물과 면역물품(생물공학적 방법에 따라 변성되거나 얻어진 것인지에 상관없다)",
            "nameOrigin": "Antisera, other blood fractions and immunological products, whether or not modified or obtained by means of biotechnological processes :"
          },
          {
            "hsCode": "300212",
            "name": "면역혈청과 그 밖의 혈액 분획물",
            "nameOrigin": "Antisera and other blood fractions"
          },
          {
            "hsCode": "3002122000",
            "name": "면역혈청",
            "nameOrigin": "Antisera"
          }
        ]
      },
      {
        "hsCode": "3002123000",
        "name": "사람의 피, 치료용ㆍ예방용ㆍ진단용으로 조제한 동물의 피, 면역혈청ㆍ그 밖의 혈액 분획물과 면역물품(생물공학적 방법에 따라 변성되거나 얻어진 것인지에 상관없다), 백신ㆍ독소ㆍ미생물 배양체(효모는 제외한다)와 이와 유사한 물품, 세포 배양체(변성된 것인지에 상관없다) (3002) --> 면역혈청, 그 밖의 혈액 분획물과 면역물품(생물공학적 방법에 따라 변성되거나 얻어진 것인지에 상관없다) (3002.1) --> 면역혈청과 그 밖의 혈액 분획물 (3002.12) --> 그 밖의 혈액 분획물 (3002.12-3000)",
        "nameOrigin": "Human blood; animal blood prepared for therapeutic, prophylactic or diagnostic uses; antisera, other blood fractions and immunological products, whether or not modified or obtained by means of biotechnological processes; vaccines, toxins, cultures of micro-organisms(excluding yeasts) and similar products; cell cultures, whether or not modified. (3002) --> Antisera, other blood fractions and immunological products, whether or not modified or obtained by means of biotechnological processes : (3002.1) --> Antisera and other blood fractions (3002.12) --> Other blood fractions (3002.12-3000)",
        "details": [
          {
            "hsCode": "3002",
            "name": "사람의 피, 치료용ㆍ예방용ㆍ진단용으로 조제한 동물의 피, 면역혈청ㆍ그 밖의 혈액 분획물과 면역물품(생물공학적 방법에 따라 변성되거나 얻어진 것인지에 상관없다), 백신ㆍ독소ㆍ미생물 배양체(효모는 제외한다)와 이와 유사한 물품, 세포 배양체(변성된 것인지에 상관없다)",
            "nameOrigin": "Human blood; animal blood prepared for therapeutic, prophylactic or diagnostic uses; antisera, other blood fractions and immunological products, whether or not modified or obtained by means of biotechnological processes; vaccines, toxins, cultures of micro-organisms(excluding yeasts) and similar products; cell cultures, whether or not modified."
          },
          {
            "hsCode": "30021",
            "name": "면역혈청, 그 밖의 혈액 분획물과 면역물품(생물공학적 방법에 따라 변성되거나 얻어진 것인지에 상관없다)",
            "nameOrigin": "Antisera, other blood fractions and immunological products, whether or not modified or obtained by means of biotechnological processes :"
          },
          {
            "hsCode": "300212",
            "name": "면역혈청과 그 밖의 혈액 분획물",
            "nameOrigin": "Antisera and other blood fractions"
          },
          {
            "hsCode": "3002123000",
            "name": "그 밖의 혈액 분획물",
            "nameOrigin": "Other blood fractions"
          }
        ]
      }
    ]
  }
}