추가 폼 항목이 없습니다. 인증 헤더만 보내면 됩니다.
successboolean
목록 조회 성공 여부. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 해당 처리가 정상 완료된 경우, false = 실패·대상 없음으로 결과를 쓸 수 없는 경우입니다.
updatedAtstring
목록의 최근 갱신 시각. ISO 8601 일시. 이력이 없으면 null. null 허용.
summaryobject
택배사 상태를 한눈에 보여 주는 요약 집계입니다. 전체·조회 가능·점검 중인 택배사 수를 담으며, 개별 목록은 아래 배열에서 확인하세요.
summary.totalinteger
상태 집계 대상 택배사의 전체 수입니다. 조회 가능·점검 중인 수를 합한 값과 일치합니다.
summary.activeinteger
현재 정상적으로 배송 조회를 지원하는 택배사 수입니다. 전체 중 점검·확인 중인 곳을 제외한 값입니다.
summary.maintenanceinteger
점검·확인 중이어서 일시적으로 조회가 제한된 택배사 수입니다. 0이면 모든 택배사가 정상입니다.
activeCarriersarray
현재 조회 가능한 택배사 목록입니다. 각 항목의 코드·이름·별칭을 함께 제공하며, 없으면 빈 배열입니다.
activeCarriers[].codestring
택배사 코드. 지정 조회의 carrier에 사용합니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
activeCarriers[].namestring
택배사 표시 이름. 대상의 표시 이름입니다. 같은 API에서도 사람·상품·채널 이름을 뜻할 수 있습니다.
activeCarriers[].aliasesarray
같은 택배사를 가리키는 다른 이름 목록입니다. 고객이 입력한 이름이 별칭과 일치하면 같은 택배사로 매핑할 수 있습니다.
activeCarriers[].serviceTypestring
택배사의 배송 서비스 분류입니다. 택배·화물·국제 등 서비스 범위를 구분합니다.
activeCarriers[].lookupTypestring
배송 조회에 필요한 입력 방식입니다. 운송장번호만으로 조회되는지, 택배사 코드가 필요한지 나타냅니다.
activeCarriers[].publicTrackingboolean
택배사가 고객용 배송 조회 페이지를 공개하는지 여부입니다. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 택배사가 고객용 배송 조회 페이지를 공개한 경우, false = 택배사가 공개 배송 조회 페이지를 제공하지 않는 경우입니다.
activeCarriers[].statusstring
ACTIVE=조회 가능, MAINTENANCE=점검 중, CHECKING=확인 중, UNAVAILABLE=상태 정보 없음. 가능한 값은 4가지입니다. ACTIVE = 정상 조회 가능한 상태입니다. 바로 요청할 수 있습니다. MAINTENANCE = 점검 중이라 조회할 수 없는 상태입니다. 복구된 뒤 같은 요청으로 다시 확인합니다. CHECKING = 상태를 확인 중인 값입니다. 잠시 후 같은 요청으로 다시 조회합니다. UNAVAILABLE = 상태 정보를 얻지 못한 값입니다. 일시 장애일 수 있으므로 재시도하고, 계속되면 문의하세요.
- 허용값
ACTIVE MAINTENANCE CHECKING UNAVAILABLE
activeCarriers[].availableboolean
현재 이 택배사의 조회가 가능한지 여부입니다. false면 점검 중이거나 일시적으로 조회할 수 없는 상태입니다. true = 지금 조회 가능한 경우, false = 점검 등으로 지금은 조회할 수 없는 경우입니다.
activeCarriers[].staleboolean
택배사 상태 정보가 갱신 기준 시간을 넘겼는지 여부입니다. true면 표시된 상태가 오래되었을 수 있습니다. true = 상태 정보가 갱신 기준 시간을 넘겨 오래된 경우, false = 최신 상태인 경우입니다.
activeCarriers[].checkedAtstring
최근 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
activeCarriers[].lastSuccessAtstring
최근 정상 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
activeCarriers[].lastFailureAtstring
최근 실패 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
activeCarriers[].errorCodestring
최근 상태 확인 코드. 문제가 없거나 이력이 없으면 null. 알려지지 않은 코드도 처리하세요. null 허용.
activeCarriers[].sourcestring
상태가 마지막으로 갱신된 방식의 구분값. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
maintenanceCarriersarray
점검·확인 중인 택배사 목록입니다. 조회가 제한된 기간에는 이 목록에만 나타날 수 있습니다.
maintenanceCarriers[].codestring
택배사 코드. 지정 조회의 carrier에 사용합니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
maintenanceCarriers[].namestring
택배사 표시 이름. 대상의 표시 이름입니다. 같은 API에서도 사람·상품·채널 이름을 뜻할 수 있습니다.
maintenanceCarriers[].aliasesarray
점검 중인 택배사의 별칭 목록입니다. 고객 입력 이름을 정규화할 때 사용하세요.
maintenanceCarriers[].serviceTypestring
점검 중인 택배사의 배송 서비스 분류입니다. 정상 복구 후 activeCarriers에서 다시 확인하세요.
maintenanceCarriers[].lookupTypestring
점검 중인 택배사의 조회 입력 방식입니다. 복구 후에도 같은 방식으로 조회합니다.
maintenanceCarriers[].publicTrackingboolean
점검 중인 택배사의 공개 조회 페이지 제공 여부입니다. false면 고객 안내에 자체 조회 화면을 쓰세요. true = 택배사가 고객용 배송 조회 페이지를 공개한 경우, false = 택배사가 공개 배송 조회 페이지를 제공하지 않는 경우입니다.
maintenanceCarriers[].statusstring
ACTIVE=조회 가능, MAINTENANCE=점검 중, CHECKING=확인 중, UNAVAILABLE=상태 정보 없음. 가능한 값은 4가지입니다. ACTIVE = 정상 조회 가능한 상태입니다. 바로 요청할 수 있습니다. MAINTENANCE = 점검 중이라 조회할 수 없는 상태입니다. 복구된 뒤 같은 요청으로 다시 확인합니다. CHECKING = 상태를 확인 중인 값입니다. 잠시 후 같은 요청으로 다시 조회합니다. UNAVAILABLE = 상태 정보를 얻지 못한 값입니다. 일시 장애일 수 있으므로 재시도하고, 계속되면 문의하세요.
- 허용값
ACTIVE MAINTENANCE CHECKING UNAVAILABLE
maintenanceCarriers[].availableboolean
점검 중인 택배사의 현재 조회 가능 여부입니다. 점검 중에는 false입니다. true = 지금 조회 가능한 경우, false = 점검 등으로 지금은 조회할 수 없는 경우입니다.
maintenanceCarriers[].staleboolean
점검 중인 택배사의 상태 정보가 갱신 기준을 넘겼는지 여부입니다. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 상태 정보가 갱신 기준 시간을 넘겨 오래된 경우, false = 최신 상태인 경우입니다.
maintenanceCarriers[].checkedAtstring
최근 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
maintenanceCarriers[].lastSuccessAtstring
최근 정상 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
maintenanceCarriers[].lastFailureAtstring
최근 실패 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
maintenanceCarriers[].errorCodestring
최근 상태 확인 코드. 문제가 없거나 이력이 없으면 null. 알려지지 않은 코드도 처리하세요. null 허용.
maintenanceCarriers[].sourcestring
상태가 마지막으로 갱신된 방식의 구분값. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
carriersarray
전체 택배사 목록. 상태 집계 대상 밖의 항목은 UNAVAILABLE일 수 있습니다.
carriers[].codestring
택배사 코드. 지정 조회의 carrier에 사용합니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
carriers[].namestring
택배사 표시 이름. 대상의 표시 이름입니다. 같은 API에서도 사람·상품·채널 이름을 뜻할 수 있습니다.
carriers[].aliasesarray
같은 택배사를 가리키는 이름 목록. 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. 항목 수와 순서를 함께 확인하세요.
carriers[].serviceTypestring
배송 서비스 분류. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
carriers[].lookupTypestring
조회 유형. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
carriers[].publicTrackingboolean
공개 배송 조회 지원 여부. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 택배사가 고객용 배송 조회 페이지를 공개한 경우, false = 택배사가 공개 배송 조회 페이지를 제공하지 않는 경우입니다.
carriers[].statusstring
ACTIVE=조회 가능, MAINTENANCE=점검 중, CHECKING=확인 중, UNAVAILABLE=상태 정보 없음. 가능한 값은 4가지입니다. ACTIVE = 정상 조회 가능한 상태입니다. 바로 요청할 수 있습니다. MAINTENANCE = 점검 중이라 조회할 수 없는 상태입니다. 복구된 뒤 같은 요청으로 다시 확인합니다. CHECKING = 상태를 확인 중인 값입니다. 잠시 후 같은 요청으로 다시 조회합니다. UNAVAILABLE = 상태 정보를 얻지 못한 값입니다. 일시 장애일 수 있으므로 재시도하고, 계속되면 문의하세요.
- 허용값
ACTIVE MAINTENANCE CHECKING UNAVAILABLE
carriers[].availableboolean
현재 조회 가능한지 여부. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 지금 조회 가능한 경우, false = 점검 등으로 지금은 조회할 수 없는 경우입니다.
carriers[].staleboolean
상태 정보가 갱신 기준을 넘겼는지 여부. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 상태 정보가 갱신 기준 시간을 넘겨 오래된 경우, false = 최신 상태인 경우입니다.
carriers[].checkedAtstring
최근 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
carriers[].lastSuccessAtstring
최근 정상 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
carriers[].lastFailureAtstring
최근 실패 확인 시각. ISO 8601 일시. 이력이 없으면 null. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. null 허용.
carriers[].errorCodestring
최근 상태 확인 코드. 문제가 없거나 이력이 없으면 null. 알려지지 않은 코드도 처리하세요. null 허용.