查詢使用者資訊或檔案資訊

<!--?xml version="1.0" encoding="utf-8" ?-->
<getinfo>
  <userid>{ User ID }</userid>
  <token>{ token }</token>
  <time>{ time stamp, this is for scramble the payload }</time>
</getinfo>

<!--?xml version="1.0" encoding="utf-8" ?-->
<getinfo>
  <status>{ Status Code }</status>
  <account>{ Account ID }</account>
  <email>{ Email Address }</email>
  <regyear>{ regYear }</regyear> <!-- 此值目前固定為 2008 --> 
  <language>{ zh-tw }</language> 
  <activateddate>{ 啟用時間，格式為 yyyy-MM-dd HH:mm:ss }</activateddate>
  <credential>{ 用戶的 OTP Credential ID }</credential> <!-- 未使用 OTP 機制的用戶此欄為空字串 --> 
  <credentialstate>{ 用戶 OTP Credential ID 的現行狀態 }</credentialstate> <!--未使用 OTP 機制的用戶此欄為空字串 --> 
  <usedbackuppc>{ 個數 }</usedbackuppc> <!-- 此帳號已使用的備份電腦資料夾個數--> 
  <backuppc> <!-- 此 Element 可重覆多次 --> 
    <name>{ 備份電腦的資料夾名稱的 Base64 編碼結果字串 }</name> <!-- 若您使用的開發語言為 Ruby，請用 Base64.strict_encode64，避免“\n”在編碼之後出現。--> 
    <createdtime>{ 格式為yyyy-MM-dd HH:mm:ss }</createdtime> <!-- 備份電腦建立時間 --> 
  </backuppc> 
  
  <package>
    <id>{ Package ID }</id>
    <display>{ EeePC-20G }</display> <!-- package name -->
    <capacity>{ 容量大小。Ex:20000 }</capacity> <!-- 計量單位 MB --> 
    <uploadbandwidth>{ 頻寬。Ex:128 }</uploadbandwidth> <!-- 計量單位 KB --> 
    <downloadbandwidth>{ 頻寬。Ex:128 }</downloadbandwidth> <!-- 計量單位 KB --> 
    <upload>{ Ex:128 }</upload> <!-- 計量單位 MB --> 
    <download>{ Ex:128 }</download> <!-- 計量單位 MB --> 
    <concurrentsession>{ # 幾個session(數值) }</concurrentsession>
    <maxfilesize>{ 檔案上傳容量上限 }</maxfilesize> <!-- 單位為 MB -->
    <hasencryption>[ 0 | 1 ]</hasencryption>
    <expire>{ 到期日(格林威治時間)，yyyy-MM-dd HH:mm:ss }</expire>
    <maxbackuppc>{ 備份電腦數上限 }</maxbackuppc>
    <featurelist>
      <feature name="{ 功能名稱，例如：MEar }" enable="[ 0 | 1 ]"> <!-- feature 可以重覆出現多次描述多個功能項目 -->
        <property name="{ 功能屬性名稱 }" value="{ 功能屬性值 }"></property> <!-- property 可以重覆出現，多次描述多個功能屬性 -->
      </feature> 
    </featurelist> 
  </package>
  
  <usedcapacity>{ 已使用空間 }</usedcapacity> <!-- 單位為 MB -->
  <freecapacity>{ 剩餘可用空間 }</freecapacity> <!-- 單位為 MB --> 
  
</getinfo>

<!--?xml version="1.0" encoding="utf-8"?--> 
<browse> 
  <token>{ token }</token> 
  <language>{ 使用者的語系，例如：zh_TW }</language> 
  <userid>{ User ID }</userid> 
  <folderid>{ Folder ID }</folderid> <!-- 欲瀏覽的目錄ID --> 
  <type>[ FOLDER | DOC | IMAGE | VIDEO | MUSIC | OTHERS ]</type> <!-- 選擇性欄位。不傳此參數，將顯示所有結果；若輸入固定參數，則可決定要瀏覽顯示子目錄或是特定類別的檔案。詳情請參閱此 API 的「TYPE參數說明」 --> 
  <pageno>{ 要索取的頁面號碼#(第一頁為1)。例如：17 }</pageno> 
  <pagesize>{ 指定一頁要顯示的筆數 }</pagesize> 
  <sortby>[ 1 | 2 ]</sortby><!-- 1：以名稱排序 | 2：以最後修改時間排序 --> 
  <sortdirection>[ 0 | 1 ]</sortdirection><!-- 0：升冪排序(ASC) | 1：降冪排序(DESC) --> 
</browse>

<!--?xml version="1.0" encoding="utf-8" ?--> 
<browse> 
  <status>{ Status Code }</status> 
  <rawfoldername>{ 當前瀏覽的目錄名稱 }</rawfoldername> 
  <parent>{ 當前瀏覽目錄的父目錄ID(parent folder ID) }</parent> 
  <rootfolderid>{ 當前瀏覽目錄的根目錄ID(root folder ID) }</rootfolderid> 
  <page> <pageno>{ 當前頁面號碼#(第一頁為1) }</pageno><!-- 當pageno值小於 1 則伺服器回應值為 1；當指定 pageno 大於最大頁數，則伺服器回應為最後一頁 --> 
  <pagesize>{ 當前頁面的子目錄 + 檔案之筆數# }</pagesize> 
  <totalcount>{ 當前瀏覽目錄的子目錄 + 檔案總筆數 }</totalcount> 
  <hasnextpage>[ 0 | 1 ]</hasnextpage> </page> 
  
  <folder> <!-- 可多筆 -->
    <id>{ Folder ID }</id> 
    <rawfoldername>{ 目錄名稱 }</rawfoldername> 
    <treesize>{ 該目錄下所有檔案佔用的硬碟空間總和 }</treesize> <!-- 單位byte --> 
    <isgroupaware>[ 0 | 1 ]</isgroupaware> <!-- 1：已啟用協同合作資料夾功能。詳情請參考「InfoRelay分享功能簡介」的說明 --> 
    <isbackup>[ 0 | 1 ]</isbackup> <!-- 若為1表示是備份的檔案或目錄，否則為一般檔案或目錄 --> 
    <isorigdeleted>[ 0 | 1 ]</isorigdeleted> <!-- 0：原始檔未刪除 | 1：原始檔已刪除 --> 
    <ispublic>[ 0 | 1 ]</ispublic> <!-- 使用者是否已設定為分享目錄。0：意指PRIVATE | 1：意指PUBLIC(已分享) -->
     <createdtime>{ yyyy-MM-dd HH:mm:ss }</createdtime> <!-- 凡目錄經過移動、更名……等動作後，此參數值皆會更動 --> 
     <markid>{ 附屬於該目錄的標示 ID(Mark ID 請參閱註解)，多個標示 ID(Mark ID)之間以空白字元分隔 }</markid> 
  </folder>
  
  <file> <!-- 可多筆 -->
     <id>{ File ID }</id> 
     <rawfilename>{ 檔案名稱 }</rawfilename>
      <isgroupaware>[ 0 | 1 ]</isgroupaware> <!-- 1：已啟用協同合作資料夾功能。詳情請參考 InfoRelay 分享功能簡介 的說明 --> 
      <size>{ 檔案大小(File Size) }</size> <!-- 單位：byte -->
       <isbackup>[ 0 | 1 ]</isbackup> <!-- 若為1表示是備份的檔案或目錄，否則為一般檔案或目錄 --> 
       <isorigdeleted>[ 0 | 1 ]</isorigdeleted> <!-- 0：原始檔未刪除 | 1：原始檔已刪除 --> 
       <isinfected>[ 0 | 1 ]</isinfected> <!-- 此欄位用以判斷檔案是否感染病毒。0：表示未感染 | 1：表示已感染 -->
        <ispublic>[ 0 | 1 ]</ispublic> <!-- 使用者是否已設定為分享。0：意指PRIVATE | 1：意指PUBLIC(已分享) --> 
        <headversion>{ 檔案的Version Number# }</headversion> 
        <createdtime>{ yyyy-MM-dd HH:mm:ss }</createdtime> <!-- 凡檔案經過移動、更名……等動作後，此參數值皆會更動 --> 
        <markid>{ 附屬於此目錄的標示 ID(Mark ID 請參閱註解)，多個標示ID(Mark ID)之間以空白字元分隔 }</markid> 
  </file> 
  <owner>{ 此目錄的擁有者 }</owner> 
</browse>

<!--?xml version="1.0" encoding="utf-8"?-->
<getlatestchangefiles>
    <userid>{ User ID }</userid>
    <token>{ token }</token>
    <top>{ 設定回傳幾筆檔案資料 }</top>    <!-- 預設值為10 -->
    <targetroot>{ 欲搜尋的系統資料夾 ID(請參閱註解)，以逗號分隔 }</targetroot>    <!-- 該參數不可填入一般資料夾 ID。系統資料夾ID相關說明，請參閱 InfoRelay Technical Spec.pdf 中的「系統資料夾 ID 列表」 -->
    <sortdirection>[ 0 | 1 ]</sortdirection>    <!-- 0：升冪排序(ASC) | 1：降冪排序(DESC)。範例：top=30,sortdirection=1，會找出用戶最近更新的、由新排到舊的30筆記錄；top=30,sortdirection=0，會找出用戶最近更新的、由舊排到新的30筆記錄 -->
</getlatestchangefiles>

<!--?xml version="1.0" encoding="utf-8"?-->
<getlatestchangefiles>
    <status>{ Status Code }</status>
    <entry>        <!-- entry 可重覆多次 -->
        <id>{ File ID | Folder ID }</id>
        <parent>{ Parent Folder ID }</parent>
        <rawfilename>{ 檔案名稱 }</rawfilename>
        <isbackup>[ 0 | 1 ]</isbackup>        <!-- 若為 1 表示是備份的檔案或目錄，否則為一般檔案或目錄 -->
        <isorigdeleted>[ 0 | 1 ]</isorigdeleted>        <!-- 0：原始檔未刪除 | 1：原始檔已刪除 -->
        <marks>{ 附屬於此檔案的標示代碼(Mark ID 請參閱註解)。若有多個標示代碼，須以空白字元分隔；若是該檔案沒有任何標示代碼時，則此欄位不出現。 }</marks>
        <createdtime>{ 格式為yyyy-MM-dd HH:mm:ss(請參閱註解) }</createdtime>
        <lastchangetime>{ 資料型別為長整數(請參閱註解) }</lastchangetime>
        <attribute>{ Data(請參閱註解) }</attribute>
        <isinfected>[ 0 | 1 ]</isinfected>        <!-- 此欄位用以判斷檔案是否感染病毒，0：表示未感染 | 1：表示已感染 -->
        <size>{ 檔案大小(File Size) }</size>
        <ispublic>[ 0 | 1 ]</ispublic>        <!-- 使用者是否已設定為分享，0：意指PRIVATE | 1：意指PUBLIC(已分享) --></entry>
</getlatestchangefiles>

<!--?xml version="1.0" encoding="utf-8"?-->
<getlatestuploads>
    <userid>{ User ID }</userid>
    <token>{ token }</token>
    <top>{ 設定回傳幾筆檔案資料 }</top>    <!-- 預設值為 10 -->
    <targetroot>{ 欲搜尋的系統資料夾ID(請參閱註解)，以逗號分隔 }</targetroot>    <!-- 該參數不可填入一般資料夾 ID。系統資料夾 ID 相關說明，請參閱 InfoRelay Technical Spec.pdf 中的「系統資料夾 ID 列表」-->
    <sortdirection>[ 0 | 1 ]</sortdirection>    <!-- 0：升冪排序(ASC) | 1：降冪排序(DESC)。範例：top=30,sortdirection=1，會找出用戶最近上傳的、由新排到舊的30筆記錄；top=30,sortdirection=0，會找出用戶最近上傳的、由舊排到新的30筆記錄 -->
</getlatestuploads>

<!--?xml version="1.0" encoding="utf-8"?-->
<getlatestuploads>
    <status>{ Status Code }</status>
    <entry>        <!-- entry 可重覆多次 -->
        <id>{ File ID | Folder ID }</id>
        <parent>{ Parent Folder ID }</parent>
        <rawfilename>{ 檔案名稱 }</rawfilename>
        <isbackup>[ 0 | 1 ]</isbackup>        <!-- 若為 1 表示是備份的檔案或目錄，否則為一般檔案或目錄 -->
        <isorigdeleted>[ 0 | 1 ]</isorigdeleted>        <!-- 0：原始檔未刪除 | 1：原始檔已刪除 -->
        <marks>{ 附屬於該檔案的標示代碼(Mark ID 請參閱註解)。若有多個標示代碼，須以空白字元分隔；如果該檔案沒有標示代碼時，則此欄位不出現 }</marks>
        <createdtime>{ 格式為 yyyy-MM-dd HH:mm:ss(請參閱註解) }</createdtime>
        <lastchangetime>{ 資料型別為長整數(請參閱註解) }</lastchangetime>
        <attribute>{ Data(請參閱註解) }</attribute>
        <isinfected>[ 0 | 1 ]</isinfected>        <!-- 此欄位用以判斷檔案是否感染病毒。0：表示未感染 | 1：表示已感染 -->
        <size>{ 檔案大小(File Size) }</size>
        <ispublic>[ 0 | 1 ]</ispublic>        <!-- 使用者是否已設定為分享，0：意指PRIVATE | 1：意指PUBLIC(已分享) --></entry>
</getlatestuploads>

<!--?xml version="1.0" encoding="utf-8"?-->
<getallchangeseq>
    <token>{ token }</token>
</getallchangeseq>

<!--?xml version="1.0" encoding="utf-8"?-->
<getallchangeseq>
    <status>{ Status Code }</status>
    <syncfolder>        <!-- 此 element 可重覆多次 -->
        <folderid>{ Folder ID }</folderid>
        <changeseq>{ Change Sequence }</changeseq>
    </syncfolder>
</getallchangeseq>

<!--?xml version="1.0" encoding="utf-8" ?-->
<getentryinfo>
    <token>{ token }</token>
    <isfolder>[ 0 | 1 ]</isfolder>    <!-- 0：表示為File ID | 1：表示為Folder ID -->
    <entryid>{ File ID | Folder ID }</entryid>
</getentryinfo>

<!--?xml version="1.0" encoding="utf-8"?-->
<getentryinfo>
    <status>{ Status Code }</status>
    <isfolder>[ 0 | 1 ]</isfolder>    <!-- 0：表示為File ID | 1：表示為Folder ID -->
    <display>{ 經過Base64(UTF-8) 編碼過後的檔案／目錄名稱 }</display>    <!-- 若您使用的開發語言為 Ruby，請用 Base64.strict_encode64，避免“\n”在編碼之後出現。-->
    <parent>{ Parent Folder ID }</parent>
    <isbackup>[ 0 | 1 ]</isbackup>    <!-- 若為 1 表示是備份的檔案或目錄，否則為一般檔案或目錄 -->
    <attribute>{ Data(請參閱註解) }</attribute>    <!-- 檔案(File)專屬欄位 begin -->
    <mimetype>{ 檔案MIME-Type }</mimetype>
    <isinfected>[ 0 | 1 ]</isinfected>    <!-- 此欄位用以判斷檔案是否感染病毒。0：表示未感染 | 1：表示已感染 -->
    <filesize>{ 單位(bytes) }</filesize>
    <createdtime>{ 檔案建立時間，格式 yyyy-MM-dd HH:mm:ss(請參閱註解) }</createdtime>
    <headversion>{ 檔案的Version Number#。}</headversion>    <!-- 檔案(File)專屬欄位 end -->
</getentryinfo>

<!--?xml version="1.0" encoding="utf-8"?-->
<propfind>
    <token>{ token }</token>
    <userid>{ User ID }</userid>
    <parent>{ Parent Folder ID }</parent>
    <find>{ 以Base64(UTF-8) 編碼的目錄名稱 }</find>    <!-- 若您使用的開發語言為 Ruby，請用 Base64.strict_encode64，避免“\n”在編碼之後出現。-->
    <type>[ system.folder | system.file | system.unknown ]</type>    <!-- system.folder指的是查詢目標為目錄；system.file 代表查詢的目標是檔案；system.unknown 則是不限定查詢目標是目錄或是檔案 -->
    <isshared>[ 0 | 1 ]</isshared>    <!-- 選擇性欄位，預設值為 0。若欲查詢的指定目錄(Parent)為他人所分享的目錄，必須將 isshared 設為 1 -->
</propfind>

<!--?xml version="1.0" encoding="utf-8"?-->
<propfind>
    <status>{ Status Code }</status>
    <isencrypted>[ 0 | 1 ]</isencrypted>
    <size>{ 檔案大小(File Size) }</size>
    <scrip>{ Scrip }</scrip>
    <type>[ system.folder | system.file | system.notfund ]</type>    <!-- system.folder 表示搜尋結果是目錄；system.file 代表檔案；system.notfund 則是沒有找到目錄或是檔案 -->
    <id>{ File ID | Folder ID }</id>
</propfind>

<!--?xml version="1.0" encoding="utf-8"?-->
<ischildrenexist>
    <token>{ token }</token>
    <userid>{ User ID }</userid>
    <folderids>{ Folder ID1,Folder ID 2,Folder ID 3…… }</folderids>    <!-- 最多200個 -->
</ischildrenexist>

<!--?xml version="1.0" encoding="utf-8"?-->
<ischildrenexist>
    <status>{ Status Code }</status>
    <requestfolder>
        <id>{ Folder ID }</id>
        <childrenexist>[ 0 | 1 ]</childrenexist>        <!-- 0：表示該目錄下的沒有檔案或子目錄存在 --></requestfolder>
    <requestfolder>
        <id>{ Folder ID }</id>
        <childrenexist>[ 0 | 1 ]</childrenexist>
    </requestfolder> …. 
</ischildrenexist>

<!--?xml version="1.0" encoding="utf-8"?-->
<getmysyncfolder>
    <userid>{ User ID }</userid>
    <token>{ token }</token>
</getmysyncfolder>

<!--?xml version="1.0" encoding="utf-8"?-->
<getmysyncfolder>
    <status>{ Status Code }</status>
    <id>{ Folder ID }</id>
</getmysyncfolder>

<!--?xml version="1.0" encoding="utf-8"?-->
<getpersonalsystemfolder>
    <token>{ token }</token>
    <userid>{ User ID }</userid>
    <rawfoldername>[ 個人系統資料夾的名稱。例如：MyRecycleBin ]</rawfoldername>
</getpersonalsystemfolder>

<!--?xml version="1.0" encoding="utf-8"?-->
<getpersonalsystemfolder>
    <status>{ Status Code }</status>
    <scrip>{ scrip }</scrip>
    <folderid>{ 個人系統資料夾的 ID(Personal System Folder ID) }</folderid>
</getpersonalsystemfolder>