일양로지스 조회 API
일양로지스는 흔히 "일양택배"라고도 부르는 (주)일양로지스의 택배 서비스입니다.
배송조회 API에서는 courier code ilyang을 쓰며, ilyanglogis로 보내도 같은 택배사로 처리됩니다.
일양로지스 소개
일양로지스는 전국의 지점과 중간 터미널을 이어 물건을 옮깁니다. 그래서 배송 이력의 한 줄 한 줄에 "○○지점", "○○터미널"처럼 그 단계를 처리한 곳의 이름이 붙어 나오고, 물건이 지금 어느 구간을 지나고 있는지 이름만 보고도 따라갈 수 있습니다.
운송장 조회는 일양로지스 홈페이지의 배송조회에서 할 수 있고, API는 이 화면이 보여 주는 것과 같은 조회 결과를 다른 택배사와 똑같은 통합 응답 형식으로 바꿔 돌려드립니다. 예전 주소였던 ilyanglogis.com이 아니라 ilyanglogis.co.kr이 현재 공식 사이트입니다.
기본 정보
| 택배사명 | 일양로지스 (일양택배) |
|---|---|
| 운영사 | (주)일양로지스 |
| API courier code | ilyang (별칭: ilyanglogis) |
| 고객센터 | 1588-0002 (평일 09:00~18:00, 토요일 09:00~13:00) |
| 조회 화면 | ilyanglogis.co.kr 배송조회 |
| 지원 범위 | 조회(tracking) 전용 — 계정 기반 등록·출력은 지원하지 않습니다 |
운송장번호 형식
일양로지스 운송장번호는 숫자 10자리입니다. 하이픈이나 공백은 빼고 숫자만 보내 주세요.
10자리라는 상한은 일양이 직접 정해 둔 값입니다. 홈페이지 조회창의 입력칸이 maxlength="10"이라 10자리를 넘게 칠 수 없고,
일양 조회 서버도 11자리 이상은 받지 않습니다. 그래서 API도 10자리를 넘는 번호는 일양에 묻기 전에 형식 오류로 돌려드립니다.
더 짧은 번호는 일양이 따로 밝힌 하한이 없어서, 저희 공통 규칙(6자리 이상)만 적용합니다.
마지막 한 자리는 검증용 숫자입니다
일양 조회 서버는 운송장번호의 끝자리로 번호가 맞는지를 확인합니다. 숫자를 잘못 옮겨 적으면 대부분 일양이
"잘못된 운송장 번호"로 돌려보내고, API는 이 경우를 조회 결과 없음(NOT_FOUND)으로 응답합니다.
다만 끝자리 한 자리로는 모든 오타를 잡지 못해, 드물게 틀린 번호가 검증을 통과해 다른 실제 송장의 이력이 조회될 수 있습니다.
저희는 이 계산을 미리 흉내 내지 않습니다. 일양이 계산 방식을 공개하지 않았기 때문에, 짐작한 규칙으로
멀쩡한 송장을 막는 것보다 일양의 판정을 그대로 전달하는 편이 안전하다고 판단했습니다.
API 연동 예시
조회는 단일 엔드포인트 호출로 끝납니다. {API_KEY}와 {SECRET_KEY}에는 발급받은 키 쌍을 넣으세요.
아래 운송장번호 1234567891은 자릿수를 보여 주기 위한 예시이며 실제 송장이 아닙니다.
curl -X POST https://api.deliveryapi.co.kr/v1/tracking/trace \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {API_KEY}:{SECRET_KEY}" \
-d '{
"items": [
{
"courierCode": "ilyang",
"trackingNumber": "1234567891"
}
]
}' items는 배열이므로 일양로지스 운송장 여러 건을 한 번에, 또는 다른 택배사 송장과 섞어서 보낼 수 있습니다.
응답 필드 정의와 오류 코드는 API 문서를 참고하세요.
배송 이력과 단계
일양로지스 이력은 출발 지점에서 물건을 내보내는 것으로 시작해, 하나 이상의 터미널을 거쳐 도착 지점에 들어온 뒤 배송 직원이 들고 나가는 순서로 쌓입니다. 실측한 배송완료 건에는 아래 네 가지 문구로 모두 5줄이 찍혔습니다 (중간 경유지 도착이 두 번).
| 이력 문구 | 찍히는 곳 | 의미 |
|---|---|---|
| 배송경유지 출고 | 출발 지점 | 물건을 받아 둔 지점이 다음 거점(터미널)으로 실어 보냄 |
| 배송경유지 도착 | 터미널 · 도착 지점 | 중간 터미널이나 배송을 맡을 지점에 들어옴 — 경로에 따라 여러 번 찍힘 |
| 직원 배송중 | 도착 지점 | 배송 직원이 물건을 싣고 수취인에게 가는 중 |
| 배달완료 | 도착 지점 | 수취인(또는 대신 받은 사람)에게 전달되어 배송이 끝남 |
이력마다 분 단위 시각이 있습니다
일양은 이력 한 줄마다 날짜와 시·분을 함께 줍니다. API는 일양 조회 화면에 보이는 것과 같은 시각을 한국 시간 기준으로
각 이력의 dateTime에 담습니다. 일양 원본은 오래된 이력부터 나열하지만, API는 다른 국내 택배사와 마찬가지로
최신 이력이 맨 앞에 오도록 정렬해 돌려드립니다.
배송 상태 코드 매핑
위 문구들은 API에서 아래 통합 상태값으로 정규화되어 나갑니다. 택배사 원문 대신 이 상태값으로 분기하면 다른 택배사와 같은 코드로 처리할 수 있습니다.
| 일양로지스 표기 | 통합 상태 | 설명 |
|---|---|---|
| 배송경유지 출고 | IN_TRANSIT | 출발 지점을 떠나 터미널로 이동 중입니다. |
| 배송경유지 도착 | IN_TRANSIT | 터미널 또는 도착 지점에 들어왔고, 아직 배송 직원이 출발하기 전입니다. |
| 직원 배송중 | OUT_FOR_DELIVERY | 배송 직원이 수취인에게 향하고 있습니다. |
| 배달완료 | DELIVERED | 수취인에게 물건이 전달되었습니다. |
"배송경유지 출고"를 배송 출발로 읽지 마세요. 여기서 "출고"는 지점이 물건을 터미널 쪽으로 내보낸다는 뜻이라,
물건은 아직 수취인 근처에도 오지 않았습니다. 그래서 통합 상태는 IN_TRANSIT이고,
수취인에게 가는 단계는 "직원 배송중"(OUT_FOR_DELIVERY)에서 따로 시작됩니다.
자주 묻는 질문 (FAQ)
일양로지스의 courier code는 무엇인가요?
표준값은 ilyang이며, 요청 본문에 "courierCode": "ilyang"으로 넣으면 됩니다.
사이트 도메인에서 딴 ilyanglogis도 별칭으로 등록되어 있어 같은 결과를 받습니다.
운송장번호를 미리 검증해도 되나요?
"숫자만, 10자리 이하"까지는 안전하게 걸러도 됩니다. 실제로 쓰이는 번호는 10자리입니다.
다만 끝자리 검증 숫자를 직접 계산해 막는 것은 권하지 않습니다 — 공개된 계산식이 없으니,
잘못된 번호인지는 조회 결과(NOT_FOUND 여부)로 판단하는 편이 정확합니다.
단, 조회가 성공했다고 해서 원래 의도한 송장이라는 보장은 아니니 수취인·상품 정보로 한 번 더 확인하세요.
조회했는데 NOT_FOUND가 나와요
세 가지 경우가 대부분입니다. 숫자 하나를 잘못 옮겨 적어 일양이 "잘못된 운송장 번호"로 판정한 경우,
일양이 "미 접수된 물품"으로 안내하는 번호(아직 일양 전산에 운송장이 올라가지 않았거나 없는 번호)인 경우,
그리고 다른 택배사의 송장을 ilyang으로 조회한 경우입니다. 번호와 택배사를 다시 확인해 보세요.
받는 분 주소나 연락처도 받을 수 있나요?
받을 수 없습니다. 수취인 주소와 휴대폰 번호는 개인정보라서, 일양 쪽 조회 결과에 들어 있더라도 API 응답에는 담지 않습니다.
보내는 분·받는 분 이름도 일양 조회 화면과 같은 방식으로 가운데를 가린 값(예: 홍*동)으로만 드립니다.
대신 각 이력에는 처리 지점 이름(location)이 들어 있고, 일양이 연락처를 함께 제공한 이력에는 그 연락처(telno — 지점 번호 또는 담당 직원 휴대폰)도 들어 있어 배송 문의처를 안내할 때 쓸 수 있습니다.
터미널 경유 이력처럼 연락처가 비어 있는 경우에는 telno가 없습니다.
운송장 발행이나 출력도 API로 되나요?
되지 않습니다. 일양로지스는 조회(tracking)만 지원합니다. 접수는 일양로지스 지점을 통해 이루어지고, 발행된 운송장번호로 배송 상태를 조회하는 데 API를 쓰게 됩니다.