디버 OpenAPI
  1. API 명세
디버 OpenAPI
  • 디버 주문접수 OpenAPI 이용안내
  • 공통
    • 1. 꼭 읽어주세요 ‼️
    • 2. 주문 상태
    • 3. API Signature 생성
    • 4. 날짜&시간 형식
    • 5. 물품정보(items) 형식
    • 6. Vehicle 상세 (퀵)
    • 7. Vehicle 상세 (화물)
    • 8. 변경이력
  • API 명세
    • 운임조회(퀵)
      POST
    • 운임조회(화물)
      POST
    • 주문접수(퀵/화물 공통)
      POST
    • 주문 상태 리스트 조회
      POST
    • 주문 상세조회(퀵/화물 공통)
      GET
    • 주문 취소요청(퀵/화물 공통)
      DELETE
  • 콜백 명세
    • 주문상태 변경 웹훅(콜백)
  • Schemas
    • Response
      • OrderLIstDTO
      • OrderListPinDTO
    • Request
      • calculator
        • quick-calculator-scheme
        • freight-calculator-scheme
        • item dto
        • vehicle dto
        • vehicle-freight-dto
      • orders
        • 구버전 orders 요청
        • 신버전 orders 요청
        • pins
    • eventName Resource
      • additionalPrice resource
      • orderDispatched resource
      • orderReDispatched resource
      • orderOngoing resource
      • orderOneCompleted resource
      • orderAllCompleted
      • orderCanceled
    • 웹훅 공통
    • calculator schema Copy
    • 운임계산 상세정보
    • 운임 상세정보
    • 주문 상태
  1. API 명세

주문 상태 리스트 조회

POST
https://openapi.dver.pe.kr/v2/orders/statuses
디버 주문번호를 이용하여 여러 주문건의 상태를 조회할 수 있습니다.

Request

Header Params

Body Params application/json

Example
{
    "orderIds": [
        1322214,
        1322215
    ]
}

Responses

🟢200Success
application/json
주문 리스트 조회 성공
Body

Example
{
    "status": 200,
    "data": {
        "orders": [
            {
                "orderId": 1322214,
                "customerOrderID": "251231-043",
                "status": "complete",
                "pins": [
                    {
                        "customerManagedCode": "251231-043-01",
                        "imageUrl": "https://example.com/image.png",
                        "completedAt": "2025-12-30T11:59:15.714Z"
                    },
                    {
                        "customerManagedCode": "251231-043-02",
                        "imageUrl": "https://example.com/image2.png",
                        "completedAt": "2025-12-30T12:59:15.714Z"
                    }
                ],
                "additionalPrices": [
                    {
                        "reason": "delay",
                        "amount": 3300,
                        "adminComment": "미배차할증",
                        "createdAt": "2025-12-30T10:58:06.470Z"
                    }
                ],
                "riderName": "홍길동",
                "riderPhoneNumber": "01012341234",
                "matchedAt": "2025-12-31T00:05:13.211Z"
            },
            {
                "orderId": 1322215,
                "customerOrderID": "251231-044",
                "status": "waiting",
                "pins": [
                    {
                        "customerManagedCode": "251231-044-01",
                        "imageUrl": "",
                        "completedAt": null
                    },
                    {
                        "customerManagedCode": "251231-044-02",
                        "imageUrl": "https://example.com/image2.png",
                        "completedAt": null
                    }
                ],
                "additionalPrices": [],
                "riderName": "홍길동",
                "riderPhoneNumber": "01012341234",
                "matchedAt": "2025-12-31T00:05:13.211Z"
            }
        ]
    }
}
🟠401Unauthorized
🔴500Server Error
Previous
주문접수(퀵/화물 공통)
Next
주문 상세조회(퀵/화물 공통)
Built with