본문으로 건너뛰기

배송 정보 조회

transportCode 로 배송의 정보를 조회할 수 있습니다.

customerCode가 있다면 고객사의 transportCode 로 등록된 배송 정보를 조회할 수 있습니다.

Request


POST https://openapi.willog.io/ext/v1/box/transports/info

Request Body

NameTypeRequiredDescription
customerCodeStringfalse고객사 코드
transportCodesArraytrue배송 코드 (최대: 100)

Example Request

POST /ext/v1/box/transports/info
Authorization: Bearer token
{
"customerCode": "customer1",
"transportCodes": [
"5089229ca9f1",
"f0531fb95d21"
]
}

Response


Response Body

NameTypeNot-nullDescription
itemsArraytrue반환되는 배열 데이터
transportCodeStringtrue배송 코드
serialStringfalse디바이스 시리얼
departureTimeUnix timestamp(ms)false출고시간
arrivalTimeUnix timestamp(ms)false도착시간
fetchedManualArrivalTimeUnix timestamp(ms)false임의도착시간

Example Response

HTTP/1.1 200 OK

{
"items": [
{
"transportCode": "5089229ca9f1",
"serial": "AB000343",
"departureTime": 1738655274000,
"arrivalTime": 1738655274000,
"fetchedManualArrivalTime": 1738655274000
}
]
}

Error Responses

- customerCode에 대한 권한 없음

HTTP/1.1 400 Bad Request

{
"code": "A0016"
}