<aside> 💡 Date: 2025-02-06

API의 신규 버전 v3 엔드 포인트가 추가되었으며, v2와 비교하여 몇 가지 중요한 변경 사항이 포함되어 있습니다. 각 버전은 별도로 유지되며, 기존 v2와 신규 v3의 차이점은 다음과 같습니다.


1. API 경로 및 버전 헤더 변경

API 경로 Version
https://api.realpacking.com/v3 2025-01-09
https://api.realpacking.com/v2 2024-01-02

1.1 올바르지 않은 API 요청 처리

  1. v2, v3 외 다른 경로로 요청하는 경우 응답 코드 400 Bad Request와 함께 아래 오류 메세지가 반환 됩니다:

    {
        "message": "Invalid API version path"
    }
    
    
  2. 경로와 버전이 일치하지 않는 경우 응답 코드 400 Bad Request와 함께 아래 오류 메세지가 반환 됩니다:

    {
        "message": "Invalid API version header"
    }
    
    
  3. v3 API key로 v2 경로에 접근하는 경우 응답 코드 403 Forbidden와 함께 아래 오류 메세지가 반환 됩니다:

    {
        "message": "You do not have access to API version 'v2'"
    }
    
    

2. API별 변경 사항

2.1 v2와 v3의 주요 차이점

v2 v3
주문 생성, 수정 API 호출 시 전화번호 형식 제한 없음 E.164 형식 필수
영상 iframe 호출 API 성공 시 http status code 200 OK, 205 Reset Content 200 OK만 지원

2.2 주문 API

3.3 영상 iframe 호출 API


3. 유의 사항