디버 OpenAPI
  1. 공통
디버 OpenAPI
  • 디버 주문접수 OpenAPI 이용안내
  • 공통
    • 1. 꼭 읽어주세요 ‼️
    • 2. 주문 상태
    • 3. API Signature 생성
    • 4. 날짜&시간 형식
    • 5. 물품정보(items) 형식
    • 6. Vehicle 상세 (퀵)
    • 7. Vehicle 상세 (화물)
    • 8. 변경이력
  • API 명세
    • 운임조회(퀵)
    • 운임조회(화물)
    • 주문접수(퀵/화물 공통)
    • 주문 상태 리스트 조회
    • 주문 상세조회(퀵/화물 공통)
    • 주문 취소요청(퀵/화물 공통)
  • 콜백 명세
    • 주문상태 변경 웹훅(콜백)
  • 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. 공통

3. API Signature 생성

개행문자는 \n을 사용합니다.
Signature 생성용 문자열을 생성하고 Secret Key를 이용하여 HMAC-SHA256 해쉬를 생성한 후 Base64로 인코딩합니다.
생성된 Base64 Hash를 HTTP header x-dver-signature-v1 의 값으로 사용하여 모든 API 요청에 첨부합니다.

생성 예시 (주문접수 API 호출용 Signature 생성예시)#

Javascript#

Java#

Signature 생성에 필요한 변수 값과 설명은 아래와 같습니다.
변수명설명예시비고
method호출할 API의 HTTP Method(대문자)GET, POST, DELETE
path호출할 API의 Resource 명/calculator, /orders운임조회 시에만 /calculator 이용, 이외 모두 /orders
timestampUNIX epoch timestamp (밀리초단위 포함 총 13자리)1606299416000
accessKey디버에서 발급한 OpenAPI AccessKey 정보abcdefg1234
secretKey디버에서 발급한 OpenAPI SecretKey 정보abcd012345677890
Previous
2. 주문 상태
Next
4. 날짜&시간 형식
Built with