<aside> 💡

Date: 2025-09-14

v3 API에 신규 버전이 추가되고 '전송페이지 URL 생성 API'의 공통 동작 방식이 변경되었습니다.

이번 업데이트의 상세 내용은 다음과 같습니다.

1. [v2, v3 공통] 전송페이지 URL 생성 API 동작 방식 변경

'전송페이지 URL 생성 API'의 정책이 변경되어 이제 호출 시마다 항상 새로운 전송페이지 URL을 생성합니다.

• 주요 변경 사항
  • 기존에는 동일한 videoCode로 URL 생성을 요청할 경우 이미 생성된 URL이 있는지 검증하고 409 Conflict 에러를 반환했습니다.
  • 업데이트 이후 위 검증 로직이 제거되었습니다. 이제 videoCode의 중복 여부와 관계없이 항상 새로운 URL이 생성되어 반환됩니다.
• 영향
  • 기존 URL 존재 여부 확인을 위해 409 Conflict 에러를 기대하고 구현된 로직이 있다면 더 이상 동작하지 않으므로 수정이 필요합니다.

2. [v3] 신규 API 버전(2025-09-14) 추가 및 변경 사항

v3 API 사용 시 Version 헤더에 2025-09-14를 지정하여 아래의 신규 기능 및 변경 사항을 적용할 수 있습니다.

2.1 신규 API 추가: 영상 재생 URL 조회

• 특정 영상의 원본 링크를 직접 조회할 수 있는 ‘영상 재생 URL 조회’ API가 추가되었습니다. 이 API는 플레이어가 포함된 iframe 대신 재생 가능한 영상의 URL 자체를 반환합니다.
• 자세한 사용법은 영상 재생 URL 조회 API 문서를 확인해주시기 바랍니다.

2.2 기존 API 변경 사항

• 전송페이지 URL 생성 API
  • Version: 2025-09-14 사용 시 요청(Request) 및 응답(Response) 형식이 변경되었습니다.
• 전송페이지 URL 조회 API
  • Version: 2025-09-14 사용 시 요청(Request) 및 응답(Response) 형식이 변경되었습니다.

3. 유의 사항

• v3 API의 신규 기능을 사용하고자 하는 경우, API 요청 헤더의 Version 값을 2025-09-14로 설정해야 합니다.
• 변경된 API를 사용하기 전, 반드시 관련 API 문서에서 새로운 요청 및 응답 형식을 확인해주시기 바랍니다. </aside>

<aside> 💡

Date: 2025-06-05

전송페이지 URL 조회 API가 개선되었습니다.

기존에는 특정 날짜 범위(created-after, created-before)를 기준으로만 전송페이지 URL을 조회할 수 있었으나 이번 업데이트를 통해 특정 영상 촬영 코드(video-code) 기준으로도 조회가 가능하도록 기능이 확장되었습니다.

이제 날짜 범위(created-after, created-before) 또는 영상 촬영 코드(video-code) 중 하나 이상의 검색 조건을 제공하면 됩니다.

단, 두 조건 모두 누락된 경우에는 요청이 실패합니다.

API 사용법에 대한 자세한 사항은 전송페이지 URL 조회 API 문서에서 확인 가능합니다.

</aside>

<aside> 💡

Date: 2025-05-29

영상 단건 삭제 API가 추가되었습니다.

API 사용법에 대한 자세한 사항은 **영상 단건 삭제 API 문서**에서 확인 가능합니다.

</aside>

<aside> 💡 Date: 2025-02-06

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

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

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의 주요 차이점

2.2 주문 API

• 엔드 포인트:
  • POST /v3/orders (주문 생성)
  • PUT /v3/orders (주문 수정)
• 변경된 매개 변수 검증:
  • 영향 받는 필드:
    • ordererPhoneNo: 주문자의 일반 전화 번호
    • ordererMobileNo: 주문자의 휴대폰 번호
    • receiverPhoneNo: 수령자의 일반 전화 번호
    • receiverMobileNo: 수령자의 휴대폰 번호
  • 전화번호 형식 요구 사항:

    • 반드시 E.164 형식이어야 합니다.

    • 잘못된 전화번호 형식으로 요청 시 응답 코드 400 Bad Request와 함께 아래 오류 메세지가 반환 됩니다:

      {
          "message": "invalid phone number. please use E.164 format"
      }
      
      

3.3 영상 iframe 호출 API

• 엔드포인트: GET /v3/videos/{videoCode}/embed
• 변경 사항:
  • 205 Reset Content 응답 코드가 제거되었습니다.
  • 성공 시 200 OK 응답만 반환합니다.

3. 유의 사항

• 각 API 호출 시 해당 버전에 맞는 경로와 버전 헤더를 사용해주시기 바랍니다.
• v2에서 v3로 전환하는 경우 주문 관련 API 요청 전에 전화번호 형식이 E.164 형식인지 반드시 검증해주시기 바랍니다.
• v2에서 v3로 전환하는 경우 영상 iframe 호출 API에서 205 Reset Content 응답을 기대하는 로직이 있다면 205 Reset Content 응답은 더 이상 지원하지 않으므로 200 OK 로 수정해주시기 바랍니다. </aside>