檔案上傳

Multipart Upload

• 伺服器：WebRelay

  • 此 API 將透過 HTTPS Multipart Upload 的方式將檔案上傳到 OmniStor 空間，並回傳該檔案所屬的 File ID。

  • 若客戶端欲取得上傳進度，則必須先對 /webrelay/initsession.jsp 發一個 HTTP Request，待客戶端收到 Response後，WebRelay 將在客戶端的 Cookie 中加入 HTTP Session，接著客戶端就可以呼叫 /webrelay/directupload/ 進行檔案上傳，最後才可以經由 /webrelay/getuploadprogress/ 取得檔案的上傳進度。而呼叫 /webrelay/initsession.jsp、/webrelay/directupload/、/webrelay/getuploadprogress/ 這三個 API 的客戶端必須為同一個 IP 才行。

  • API 參考：查詢上傳檔案進度(/webrelay/getuploadprogress/)

• 目的：接受客戶端以 HTTP Multipart Upload 方式將檔案上傳至 OmniStor 空間。此 API 並不支援續傳，若發生斷線，客戶端必須重頭開始再傳一次。

如果輸入參數ar(Auto Rename) 設為1，更名規則即在原始檔名後、副檔名前安插一個空白後再加上括號(數字 n)，若有相同檔名則遞增數字，直到沒有重覆檔名。

• 例如：原始檔名為
  「瑪莉與她的小綿羊.mov」如果遇到同檔名則改為…
  「瑪莉與她的小綿羊 (1).mov」 → 加上"一個空白"和"括號(數字 n)"

※ 若客戶端欲取得上傳進度，必須先呼叫過 /webrelay/initsession.jsp。否則，使用 /webrelay/getuploadprogress/ 時將無法取得正確的上傳檔案進度。

協同合作資料夾：

如欲使用協同合作資料夾功能時，其操作之客戶端應用程式(Client Application) 必須以 Query string 的方式帶入 SID、isgroupaware 參數及 ProgKey(必須採用 Authorization 的方式，Authorization Header 請參見 ServiceGateway 技術文件的 /member/acquiretoken/)，當 SID及ProgKey 通過 ASUSCloud Server 的認證後，方能啟用協同合作資料夾功能(如欲詳知 OmniStor 系統所提供的分享功能，請參見 InfoRelay 技術文件)。

POST /webrelay/directupload/

Input

URL rewrite 路徑參數：/{ token }/?dis={ sid }& igw = [ 0 | 1 ] & atrz = { HTTP Header "Authorization" }

Query String 路徑參數詳細說明：

• dis = { sid }

• igw = [ 0 | 1 ] （選擇性欄位，預設值為 0）
  此欄為群組分享參數，同 InfoRelay 技術文件中的<isgroupaware>。若為 1 表示要對協同合作資料夾進行上傳檔案的動作，反之則不啟用協同合作資料夾功能。。

• atrz = { Authorization String }（選擇性欄位）
  其意義同 Service Gateway 的 /member/acquiretoken/ API 所需指定的 HTTP Header "Authorization"。因採用 Query string 方式，所以此參數須經 Base64 編碼完畢後再做 URL encode }

Multipart FORM輸入參數：

• pa = { Parent Folder ID }

• d = { 經過Base64(UTF-8)編碼後 URL encode 的目錄名稱 }

• u = { Response URL }

• pr = { Progress ID }
  由客戶端指定，做為呼叫 /webrelay/getuploadprogress/ 以查詢上傳進度時所用的ID。

• at = { Attribute參數 }
  供客戶端指定任意想儲存在檔案的屬性(attribute)內的屬性字串，指定此值時須經 URL encode，以傳至 WebRelay 儲存。

• fs = { File Size }
  此參數讓客戶端指定欲上傳之檔案大小(單位為 Byte)，藉此讓 WebRealy 在接收檔案之前可判斷是否超過系統允許的上限。超過系統允許上限大小的檔案 WebRelay 會拒絕接收，回傳狀態碼 221。若未指定此參數，則會接收檔案直到超過系統允許的上限時才回傳狀態碼 221。

• fi = { 舊檔案的File ID }
  選擇性欄位。如欲覆蓋原存在於伺服器上的檔案，須指定此參數。若指定的 File ID 不存在，則被視為全新上傳。

• ar = [ 0 | 1 ]
  選擇性欄位(預設值為 0)。該欄位是自動更名(Auto-Rename)的布林參數，若上傳之檔案在伺服器上已有同名檔案，是否要自動更名? 0 表示不必自動更名，1 表示要自動更名。

• rn = { 將上傳之檔案的檔名重新命名(rename)為此參數指定的檔案名稱 }
  選擇性欄位。此字串須依序以 Base64 及 URL encode 進行編碼。
  
  例如：欲將上傳檔案易名為 Naomi_PhotoShop_Tutorial.mov
  Raw flie name：Naomi_PhotoShop_Tutorial.mov
  對Raw flie name 的編碼步驟：
  1. Base64：TmFvbWlfUGhvdG9TaG9wX1R1dG9yaWFsLm1vdg==
  2. URLencode：TmFvbWlfUGhvdG9TaG9wX1R1dG9yaWFsLm1vdg%3D%3D
  故設 rn=TmFvbWlfUGhvdG9TaG9wX1R1dG9yaWFsLm1vdg%3D%3D

Output

• 若輸入參數有指定 u (客戶端為瀏覽器)：
  以 u 所指定的 URL 作為重新導向目的地網址(URL redirection)，後綴下列參數 ?s={ Status Code } &f={ Parent Folder ID } &p={ Panel ID } &d={ Folder display } &n={ File ID }

• 若輸入參數未指定 u，則以XML 回傳結果：

回傳的狀態碼(Status Code)

回傳的 HTTP 狀態碼(HTTP Status Code)

Streaming Upload

WebRelay 提供了一組以串流(Stream)為基礎所進行傳輸的 API。並支援斷點續傳以進一步優化檔案上傳作業。

該組 API 分別為：/webrelay/initbinaryupload/、/webrelay/resumebinaryupload/、/webrelay/finishbinaryupload/。若客戶端欲使用 Binary Stream 為基礎的上傳檔案 API 時，按照順序分為三大步驟：

1. 初始化串流檔案上傳／續傳

   • 呼叫 /webrelay/initbinaryupload/。

   • 取得 Transaction ID。

   • ※ 若客戶端要進行續傳作業，則呼叫 /webrelay/initbinaryupload/ 時必須指定 tx 參數值為 Transaction ID(可由上一次伺服端回傳的 Payload中取得)。

2. 串流檔案上傳／續傳

   • 接續第一步驟，呼叫 /webrelay/resumebinaryupload/。

   • 將檔案的二進位資料透過 HTTP POST 寫至 WebRelay。

   • ※ 若客戶端要執行續傳，可以由第一步驟 WebRelay 回傳的<offset>得知檔案前次上傳進度的 byte 值，藉此接續上傳檔案內容。

   • 客戶端將檔案內容完全上傳完畢之後，須執行最後步驟(步驟三)，方能確實完成串流檔案上傳。

3. 完成串流檔案上傳／續傳

   • 客戶端經由 /webrelay/resumebinaryupload/ 將檔案內容完全上傳完畢之後，請客戶端務必呼叫 /webrelay/finishbinaryupload/，並指定 Transactoin ID，以通知 WebRelay 檔案已上傳完畢。

   • ※ 若客戶端未呼叫 /webrelay/finishbinaryupload/，則 WebRelay 會認為客戶端只是暫停上傳檔案，即未完成上傳。

覆寫檔案(Reuse File ID)

Streaming Upload 除了可以上傳新檔案和斷點續傳之外，還可將原本存於雲端的檔案覆寫。

客戶端上傳檔案時，若將欲覆寫的檔案File ID傳至伺服端，可得到該檔案在 OmniStor 上的checksum (請參閱註解)，checksum 即為檔案的特徵值字串。

當客戶端呼叫 /webrelay/finishbinaryupload/ 告知伺服端上傳完成時，客戶端須再將此 checksum 送回伺服端，伺服端藉由比對當時雲端上檔案的 checksum 和客戶端送來的 checksum 是否一致，可以確認欲覆寫的檔案在上傳過程中是否有過異動(若發生過異動則 checksum 將不一致，伺服端會回傳 Status Code 250)，如此可確保各同步裝置在同步過程中的正確率。

流程說明：

• 首先，客戶端須在 Streaming Upload步驟一裡輸入fi參數指明 File ID，而 WebRelay 將會回傳伺服器中該 File ID 的checksum。

• 接著，客戶端在步驟三時，必須將步驟一中從伺服端接收到的 checksum 傳回至 WebRelay，伺服端將會把步驟三上傳的checksum與存於伺服端的 checksum 進行比對，以確認在上傳過程中是否與其他同步裝置有更新的差異。

• 比對結果若不相同，伺服端將出現250的錯誤訊息，表示欲上傳的檔案在各同步裝置中可能有例外的更新狀況發生，客戶端便可檢查各同步裝置的更新狀況，避免各裝置同步更新發生差異。下圖為覆寫檔案(Reuse File ID)流程圖：
  
  

• Open

  

例如：客戶端上傳檔案 A'，欲覆寫在雲端上的檔案 A，客戶端須將檔案 A 的 File ID 傳至伺服端，伺服端便會回傳檔案 A 的 checksum。當客戶端使用 Streaming Upload 呼叫到 /webrelay/finishbinaryupload/ 時，客戶端須將先前拿到檔案A的 checksum 再送至伺服端，伺服端將會拿此 checksum 跟此時在伺服端上 檔案A 的 checksum 做比對，以確保 檔案A 沒有在 Streaming Upload 過程中因同步功能發生異動。

Streaming Upload Step1：初始化串流檔案上傳／續傳

• 伺服器：WebRelay

Streaming Upload 是以串流(Stream)為基礎所進行傳輸的 API，其支援斷點續傳以進一步優化檔案上傳作業。此 API 為 Streaming Upload 的第一步驟，在此步驟中有兩個目的：

1. 開始上傳：
   新建立一個串流上傳檔案的 session，並取得一個 Transaction ID，做為後續上傳動作的啟始點。

2. 斷點續傳：
   如果傳輸斷線了，而客戶端想要取得前次上傳中斷點時，則須呼叫此 API，並帶入前次上傳的 Transaction ID，以取得前次中斷點的 offset。

POST /webrelay/initbinaryupload/

Input

Query String之中各個參數以'&'分隔：

• dis = { sid }

• tk = { token }

• na = { 經過 Base64(UTF-8) 編碼後 URL encode 的檔案名稱 }
  若您使用的開發語言為 Ruby，請用 Base64.strict_encode64，避免 \n 在編碼之後出現

• pa = { Parent Folder ID } sg = [ SYSTEM.RESERVED ]
  系統保留參數，填固定字串

• at = { Attribute(請參閱註解) }
  供客戶端指定任意想儲存在檔案的屬性(attribute)內的屬性字串，指定此值時須先經 URL encode，再傳至 WebRelay 儲存。

• fs = { File Size }
  此參數讓客戶端指定欲上傳之檔案大小(單位為 Byte)，藉此讓 WebRealy 在接收檔案之前可判斷是否超過系統允許的上限。超過系統允許上限大小的檔案 WebRelay 會拒絕接收，回傳狀態碼 221。若未指定此參數，則會接收檔案直到超過系統允許的上限時才回傳狀態碼 221。

• tx = { 續傳時才使用的Transaction ID }（選擇性欄位）

• fi = { 要覆寫的File ID }（選擇性欄位）

• sc = { 此檔案上傳目的地為 Sync Folder 或 Sync Folder 的子目錄，以此參數指明其最上層為 Sync Folder }（選擇性欄位）

• igw = [ 0 | 1 ]（選擇性欄位，預設值為 0）
  此欄為群組分享參數，同 InfoRelay 技術文件中的 <isgroupaware>。若為 1 表示要對協同合作資料夾進行上傳檔案，反之則不啟用協同合作資料夾功能

Output

回傳的狀態碼(Status Code)

Streaming Upload Step2：串流檔案上傳／續傳

• 伺服器：WebRelay

• 目的：在呼叫 /webrelay/initbinaryupload/ API 取得 Transaction ID 後，即可以此 API 透過串流的方式 (Stream) 進行指定 Transaction ID 的檔案上傳作業。若為續傳的狀態，在取得 /webrelay/initbinarupload/ API 回傳的 offset 後，即可進行後續的檔案上傳。

POST /webrelay/resumebinaryupload/

Input

Query String 之中各個參數以'&'分隔：

• dis = { sid }

• tk = { token }

• tx = { Transaction ID }

• igw = [ 0 | 1 ]（選擇性欄位，預設值為 0）
  此欄為群組分享參數，同 InfoRelay 技術文件中的<isgroupaware>。若 1 表示要對協同合作資料夾進行上傳檔案，反之則不啟用協同合作資料夾功能

上傳內容則是客戶端取得 OutputStream 後以 Binary Stream 的方式寫入。

Output

回傳的狀態碼(Status Code)

回傳的 HTTP 狀態碼(HTTP Status Code)

Streaming Upload Step3：完成串流檔案上傳／續傳

• 伺服器：WebRelay

• 目的：在呼叫 /webrelay/resumebinaryupload/ API進行檔案上傳完畢後，必須呼叫此API告知伺服端已完成檔案上傳，伺服端確知客戶端不是暫停上傳後，便可進行檔案上傳完畢之處理程序，並傳回 File ID。

POST /webrelay/finishbinaryupload/

Input

Query String之中各個參數以'&'分隔：

• dis = { sid }

• tk = { token }

• tx = { Transaction ID }

• lsg = { 僅用於 Reuse File ID時，也就是呼叫 /webrelay/initbinaryupload/ 回傳之 XML 中的 latestchecksum 參數 }（選擇性欄位）

• igw = [ 0 | 1 ]（選擇性欄位，預設值為 0）
  此欄為群組分享參數，同 InfoRelay 技術文件中的 <isgroupaware>。若為 1 表示要對協同合作資料夾進行上傳檔案，反之則不啟用協同合作資料夾功能

Output

回傳的狀態碼(Status Code)

查詢上傳檔案進度

• 伺服器：WebRelay

• 目的：供客戶端查詢指定檔案上傳到 OmniStor 的上傳進度

POST /webrelay/getuploadprogress/

Input

Query String中的輸入參數：

Output

回傳的狀態碼(Status Code)

查詢影片轉檔進度

• 伺服器：WebRelay

• 目的：當客戶端上傳小於100MB的影片檔至伺服器後，伺服器除保留原始檔外，將會自動進行影像轉換，產出一個或數個解析度的 MP4檔(並不會佔據客戶端的 OmniStor 空間)，以提供給不同解析度裝置使用。此 API 可供客戶端查詢上述影像的轉換進度，以及該原始影像檔可產出的幾種解析度檔案列表。

API Output payload 中的 <progressstate>、<abstractstate>為「轉檔抽象進度」及「轉檔進度常數」，代表的是伺服端回覆客戶端轉檔進度的結果。以下為轉檔進度常數值說明列表：

轉檔進度相關列表：

POST /webrelay/getvideoconvertprogress/

Input

Query String之中各個參數以'&'分隔：

Output

• 若上傳影片檔符合系統支援轉檔的格式會回覆下列訊息

• 若上傳影片檔不符合系統支援轉檔的格式會回覆下列訊息

回傳的狀態碼(Status Code)

影片格式轉換

客戶端可使用 Multipart Upload或Streaming Upload 上傳影片檔，若影片檔大小為 100MB 以下，則伺服端將會自動進行影片格式轉換，伺服器除保留原始檔外，還會產出一個或數個解析度的 MP4 檔在伺服端(並不會額外佔據客戶端的 OmniStor 空間)，提供給不同解析度裝置使用；若影片檔大小超過 100MB，則不進行轉檔。

若客戶端欲下載轉換過後的影片檔，則須在下載之前，先呼叫「查詢影片轉檔進度(/webrelay/getvideoconvertprogress/)」以查詢確認影片檔案是否已轉檔成功。待確認已轉檔完畢後，方能順利下載，其流程請參考下圖。

Open

• 轉換標準：

影片格式轉換所使用的解析度分別為 SD(320 x 480) 和 HD(1280 x 720)。客戶端上傳的原始影像檔解析度有下述五種情況，在各情況下，伺服端將產出一個或數個解析度的MP4檔。其相關流程請參考下方「影片格式轉換流程圖」：

1. 解析度小於 SD：
   客戶端可下載原始解析度的 MP4 檔。
   ※ 例如：若上傳的影片為180 x 120的WMV檔，則客戶端可下載：180 x 120的MP4影像檔。

2. 解析度等於SD：
   客戶端可下載 SD 解析度的 MP4 檔。
   ※ 例如：若上傳的影片為SD的AVI檔，則客戶端可下載：SD的MP4影像檔。

3. 解析度大於 SD 且小於 HD：
   客戶端可下載原始解析度的 MP4 檔、SD 解析度的 MP4 檔。
   ※ 例如：若上傳的影片為 980 x 640 的 RMVB 檔，則客戶端可下載：980 x 640 的 MP4 影像檔、SD 的 MP4 影像檔。

4. 解析度等於HD：
   客戶端可下載 SD 解析度的 MP4 檔、HD 解析度的 MP4 檔。
   ※ 例如：若上傳的影片為 HD 的 RMVB 影像檔，則客戶端可下載：SD 的 MP4 影像檔、HD 的 MP4 影像檔。

5. 解析度大於 HD：
   客戶端可下載 SD 解析度的 MP4 檔、HD 解析度的 MP4 檔。
   ※ 例如：若上傳的影片為 2050 x 2000 的 RMVB 影像檔，則客戶端可下載：SD 的 MP4 影像檔、HD 的 MP4 影像檔。
   
   

檔案下載

下載

• 伺服器：WebRelay
  當 WebRelay 接收到客戶端下載檔案的請求時，WebRelay 會先取得 /member/acquiretoken/ 中的 Token，將此 Token 送往 ServiceGateway 驗證，驗證通過後，WebRelay 會找出客戶端指定的 File ID 在伺服器上的儲存路徑與檔名，並讀取該檔案回傳給客戶端。

• 目的：此 API 供客戶端指定 File ID，以下載 OmniStor 上指定該 ID 的檔案。此 API 支援 HTTP Range Partial Download，也支援續傳

GET /webrelay/getuploadprogress/

Input

• URL rewrite 路徑參數：/{ token }/

• Query String 之中各個參數以'&'分隔：

  • dis = { sid }

  • fi = { 要下載之File ID }

  • pv = [ 0 | 1 ]
    是否需要預覽(preview)，0：直接下載(預設值) | 1：預覽。

  • ve = { 欲下載的目標檔案版本(version)。 } （選擇性欄位。預設值為0）

  • u = { Response URL，指定發生錯誤時要重新導向的頁面URL }

  • of = { 指定由距離檔案開頭多少個 bytes 的 offset 開始下載 }（選擇性欄位。預設值為 0）

  • fue = [ 0 | 1 ]
    fue(Force URL Encode)：指定此參數為 1 時檔名會被強制進行 URLEncode

  • cpt = { 指定下載的影片檔解析度常數 }（選擇性欄位）
    如果客戶端欲下載轉換解析度過後的MP4影片檔，則須指定該參數值。相關資料請參考 /webrelay/getvideoconvertprogress/ 的 type 參數

  • rn = { 將上傳之檔案的檔名重新命名(rename)為此參數指定的檔案名稱 }（選擇性欄位）
    此字串須依序以 Base64 及 URL encode 進行編碼。
    例如：欲將下載檔案易名為 Naomi_PhotoShop_Tutorial.mov
    Raw flie name：Naomi_PhotoShop_Tutorial.mov
    對Raw flie name 的編碼步驟：
    1. Base64：TmFvbWlfUGhvdG9TaG9wX1R1dG9yaWFsLm1vdg==
    2. URLencode：TmFvbWlfUGhvdG9TaG9wX1R1dG9yaWFsLm1vdg%3D%3D
    故設 rn=TmFvbWlfUGhvdG9TaG9wX1R1dG9yaWFsLm1vdg%3D%3D

Output

回傳檔案。

回傳的 HTTP 狀態碼(HTTP Status Code)

取得圖片的縮圖

• 伺服器：WebRelay

• 目的：為避免因使用者上傳的圖片解析度過大，下載費時而造成相片瀏覽時的速度過於緩慢，因此提供此 API，可對該圖片進行指定解析度的縮圖，以節省資料傳輸的時間。

GET /webrelay/getresizedphoto/

Input

URL Structure：
https://{ webrelay server host }/webrelay/getresizedphoto/{ token }/{ parameters }.jpg?dis={ sid }&ecd=[ 1 ]

parameters 說明：

• pfd = { 原始圖片的File ID }

• size = { width x height }
  縮圖的尺寸(寬x高)。其中，「x」是英文字母小寫的x

• pv = [ 0 | 1 ]
  0：下載附件(預設值) | 1：預覽

Query String 中各個參數以'&'分隔：

• dis = { sid }

• ecd = [ 1 ]
  系統固定參數，請填數字 1

組成 parameters 的步驟：

• Step 1. 參數依序以逗點分隔：pfd={ Photo File ID },size={ width x height },pv=[ 0 | 1 ]

• Step 2. 將第 1 步驟得到的參數做 Base64 編碼

Input 範例：當Token = test123, sid = 123, File ID = 12345

範例 URL 結果：
https://{ webrelay server host }/webrelay/getresizedphoto/test123/ cGZkPTEyMzQ1NixzaXplPTY0MHg0ODAscHY9MQ==.jpg?dis=123&ecd=1

Output

若客戶端傳來的HTTP Header：

包含 If-Modified-Since 且該時間大於等於欲索取檔案的最後更新時間。 包含 If-None-Match，且客戶端傳來的 If-None-Match 與 Etag 值(本 API 中設為檔案的最後更新時間，long 整數值格式)相同，則回傳 HTTP Status 304 (HttpServletResponse.SC_NOT_MODIFIED)。

回傳縮圖結果：

縮圖失敗時，則回傳給客戶端的 HTTP Content-Length 設為 0(讓客戶端可以顯示自身準備的圖示)。 縮圖成功即回傳指定的圖檔。

※ HTTP 相關資訊請參考 Hypertext Transfer Protocol -- HTTP/1.1

回傳的 HTTP 狀態碼(HTTP Status Code)

由指定檔案萃取文字檔

• 伺服器：WebRelay

• 目的：為避免客戶端無支援指定文件格式的應用軟體(例如：MS Office、PDF…等)，提供此 API 用以萃取指定之檔案的內容為純文字、XML 或 HTML 格式回傳，以便不時之需。

• Companion file type(此 API 之參數 "k" 的值)：

  • 0 - plain text

  • 1 - XML

  • 2 - HTML

GET /webrelay/getfulltextcompanion/

Input

URL Structure：
https://{ webrelay server host }/webrelay/getfulltextcompanion/{ token }/{ parameters }.txt?dis={ sid }&ecd=[ 1 ]

parameters說明：

• fi = { 要下載之中間過程文字檔的原始檔案 File ID }

• pv = [ 0 | 1 ]<!-- 0：附件下載(預設值) | 1：預覽 -->

• k = { companion file type。未指定此參數時預設值為 0，表示純文字檔 } <!-- 選擇性欄位 -->

Query String 中各個參數以'&'分隔：

• dis = { sid }

• ecd = [ 1 ]
  系統固定參數，請填數字 1

組成parameters的步驟：

• Step 1. 參數依序以逗點分隔：fi={ 要下載之中間過程文字檔的原始檔案 File ID },pv=[ 0 | 1 ],k={ companion file type }

• Step 2. 將第1步驟得到的參數做 Base64 編碼

Input 範例：當 Token = test123, sid = 123, File ID = 12345

範例 URL 結果：
https://{ webrelay server host }/webrelay/getfulltextcompanion/test123/ Zmk9MTIzNDUscHY9MCxrPTA=.txt?dis=123&ecd=1

Output

回傳檔案。 若來源檔是不支援的檔案格式則回傳預設文字「This companion file is broken because converted fail!」

回傳的 HTTP 狀態碼(HTTP Status Code)

擷取影片預覽圖

• 伺服器：WebRelay

• 目的：為輔助客戶端進行影片的預覽，此 API 會擷取指定影片檔第10秒的截圖回傳。

GET /webrelay/getvideosnapshot/

Input

URL Structure：
https://{ webrelay server host }/webrelay/getfulltextcompanion/{ token }/{ parameters }.txt?dis={ sid }&ecd=[ 1 ]

parameters 說明：

• fi = { 要下載之預覽影像圖檔的原始影片 File ID }

• pv = [ 0 | 1 ]
  是否預覽(preview)。0：直接下載(預設值) | 1：預覽。

Query String中各個參數以'&'分隔：

• dis = { sid }

• ecd = [ 1 ]
  系統固定參數，請填數字 1

組成parameters的步驟：

• Step 1. 參數依序以逗點分隔：fi={ 要下載之預覽影像圖檔的原始影片File ID },pv=[ 0 | 1 ].jpg

• Step 2. 將第 1 步驟得到的參數做 Base64 編碼

Input範例：當Token = test123, sid = 123, File ID = 12345

範例 URL 結果：
https://{ webrelay server host }/webrelay/getfulltextcompanion/test123/ Zmk9MTIzNDUscHY9MCxrPTA=.txt?dis=123&ecd=1

Output

回傳檔案。 若取得 snapshot 失敗，則回傳預設圖片。

回傳的 HTTP 狀態碼(HTTP Status Code)

其他注意事項

服務區域 ID 列表