배송 정보 조회
transportCode 로 배송의 정보를 조회할 수 있습니다.
customerCode가 있다면 고객사의 transportCode 로 등록된 배송 정보를 조회할 수 있습니다.
Request
POST https://openapi.willog.io/ext/v1/box/transports/info
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
| customerCode | String | false | 고객사 코드 |
| transportCodes | Array | true | 배송 코드 (최대: 100) |
Example Request
POST /ext/v1/box/transports/info
Authorization: Bearer token
{
"customerCode": "customer1",
"transportCodes": [
"5089229ca9f1",
"f0531fb95d21"
]
}
Response
Response Body
| Name | Type | Not-null | Description |
|---|---|---|---|
| items | Array | true | 반환되는 배열 데이터 |
| transportCode | String | true | 배송 코드 |
| serial | String | false | 디바이스 시리얼 |
| departureTime | Unix timestamp(ms) | false | 출고시간 |
| arrivalTime | Unix timestamp(ms) | false | 도착시간 |
| fetchedManualArrivalTime | Unix 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"
}