<aside> 💡

Date: 2025-06-05

送信ページ URL閲覧API が改善されました。

これまでは、created-after および created-before による 日付範囲のみで転送ページのURLを取得できましたが、

今回のアップデートにより、特定の映像撮影コード（video-code）による検索も可能になりました。

このAPIを使用する際は、日付範囲または映像撮影コードのいずれかを必ず指定してください。

両方が省略された場合、リクエストは失敗します。

APIの利用方法については、送信ページ URL閲覧APIドキュメントをご参照ください。

</aside>

<aside> 💡

Date: 2025-05-29

特定の映像を削除する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: 注文者の電話番号
    • receiverMobileNo: 受取人の携帯電話番号
    • receiverPhoneNo: 受取人の電話番号
  • 電話番号形式リクエスト:

    • 必ず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>