URI-C-02 型錄認證/公司認證燈箱

JasonWu

tags: URI-C

內容

網址

• https://www.taiwantrade.com/lightbox/certification/948901?companyId=97301

相關示意圖

• 公司認證燈箱
  
• 型錄認證燈箱
  

相關程式

Input JSON Path

規格

• path : ${TT-API網址}/certifications/{certType}/{certId}
• method : GET
• query : ?langId={langId}&companyId={cid}

Input

欄位名稱	欄位說明	資料型態	是否必要欄位	備註
certType	認證類型	string	Y	分公司認證(com)、型錄認證(prod)
certId	認證id	number	Y	int
langId	語系id	number	Y	int
cid	公司id	number	Y	int

==舊版紀錄如下

Column	Type	Require	Desc
certType	string	Y	認證類型，分公司認證、型錄認證
certId	number	Y	認證id
langId	number	Y	語系id
cid	number	Y	公司id

範例

https://tt-api.taiwantrade.com/certifications/prod/702355?cid=147927&langId=42
https://tt-api.taiwantrade.com/certifications/com/700437?langId=42&cid=147927

邏輯

• 傳入認證類型、認證 id、認證顯示語系、公司 id
• 認證類型分兩類，對應參數紀錄如下
  • 公司認證: com
  • 產品認證: prod
• 產品認證下方需要有對應的推薦型錄，公司認證沒有
• 解析 json 內容後顯示
• 如果欄位內容為空，例如認證結束時間為空，那就不需要顯示此欄位

Output JSON Path

規格

{ 
    "code" : <code>,
    "errorMsg" : <errorMsg>,
    "intervalTime" : <intervalTime>,
    "data" : {
        "certInfo" : {
            "certId" : <certId>,
            "companyName" : <companyName>,
            "serial" : <serial>,
            "startTime" : <startTime>,
            "endTime" : <endTime>,
            "name" : <name>,
            "desc" : <desc>,
            "imgUrl" : <imgUrl>,
            "fileName" : <fileName>,
            "fileSize" : <fileSize>,
            "fileUrl" : <fileUrl>,
            "hasMoreProduct" : <hasMoreProduct>,
            "productLpUrl" : <productLpUrl>,
            "refProductRows" : [
                {
                    "productId" : <productId>,
                    "productName" : <productName>,
                    "imgUrl" : <imgUrl>,
                    "productCpUrl" : <productCpUrl>
                },...
            ]
        }    
    }
}

輸出參數說明

認證燈箱輸出欄位

欄位名稱	欄位說明	資料型態	是否可為空值	備註
code	執行狀態代碼	number	N	int code=0為正常 code<0為錯誤
errorMsg	錯誤訊息	string	N
intervalTime	執行時間	string	N	顯示執行時間，單位 ms
certInfo	認證燈箱元件	燈箱元件(Object)	Y

==舊版紀錄如下

欄位名稱	欄位說明	型態	是否可為空值
code	代碼	int	0表示ok
errorMsg	錯誤訊息	String
certInfo	認證燈箱元件	燈箱元件(Object)	Y

燈箱元件

欄位名稱	欄位說明	資料型態	是否可為空值	備註
certId	認證 id	number	N Y	int
companyName	公司名稱	string	N
serial	認證序號	string	N Y
startTime	認證開始時間	number	Y	long
endTime	認證結束時間	number	Y	long
name	認證名稱	string	N Y
desc	認證說明	string	Y
imgUrl	認證圖片 url	string	N
fileName	認證附件檔案名稱	string	Y
fileSize	認證附件檔案大小	string	Y
fileUrl	認證附件下載路徑	string	Y
refProductRows	推薦型錄元件	推薦型錄元件(Object)	Y

==舊版紀錄如下

欄位名稱	欄位說明	型態	是否可為空值
certId	認證 id	int	N
companyName	公司名稱	String	N
serial	認證序號	String	N
startTime	認證開始時間	String number	Y
endTime	認證結束時間	String number	Y
name	認證名稱	String	N
desc	認證說明	String	Y
imgUrl	認證圖片 url	String	N
fileName	認證附件檔案名稱	String	Y
fileSize	認證附件檔案大小	String	Y
fileUrl	認證附件下載路徑	String	Y
refProductRows	推薦型錄元件	推薦型錄元件(Object)	Y

推薦型錄元件

欄位名稱	欄位說明	資料型態	是否可為空值	備註
productId	相關型錄 id	number	N	int
productName	型錄名稱	string	N
imgUrl	型錄圖片 url	string	N
productCpUrl	型錄詳目頁 url	string	Y

==舊版紀錄如下

欄位名稱	欄位說明	型態	是否可為空值
productId	相關型錄 id	int	N
productName	型錄名稱	String	N
imgUrl	型錄圖片 url	String	N
productCpUrl	型錄詳目頁 url	String	Y

範例

{
    "code" : 0,
    "errorMsg" : "",
    "intervalTime" : "250 ms",
    "data" : {
        "certInfo" : {
            "certId" : 702419,
            "companyName" : "HYWEB TECHNOLOGY CO., LTD.",
            "serial" : "CSA",
            "startTime" : "",
            "endTime" : "",
            "name" : "CSA",
            "desc" : "",
            "imgUrl" : "//im01.ttstaging.com.tw/48001ac5-7dfb-4754-8039-3925846a342f/CSA.png",
            "fileName" : "",
            "fileSize" : "",
            "fileUrl" : "",
            "refProductRows" : [
                {
                    "productId" : 1792867,
                    "productName" : "(En)Service CRM System",
                    "imgUrl" : "https://im01.ttstaging.com.tw/a9ad9aca-ce02-45ec-bfef-f73aa1fcc1fb/0546db0d-3ce8-4805-9fa6-6ca7b67392e5_33_201500014734_L-100x100.jpg",
                    "productCpUrl" : "https://hyweb.en.ttstaging.com.tw/product/en-service-crm-system-1792867.html",
                },
                {
                    "productId" : 1800815,
                    "productName" : "Mini Laptop Computer HyRe...",
                    "imgUrl" : "https://im01.ttstaging.com.tw/2ce655f4-ac1c-48b2-abaf-4ab63dba291f/Laptop-100x100.jpg",
                    "productCpUrl" : "https://hyweb.en.ttstaging.com.tw/product/mini-laptop-computer-hyread-1800815.html",
                },
            ]
        }
    }

}

頁面操作相關邏輯(頁面按鈕、點選相關邏輯)

基本燈箱操作

• 燈箱開啟時，背景需要顯示 mask，mask 就是燈箱背景的黑色區域，可凸顯燈箱，且後方會被 mask 蓋住，就不會點到後面的功能
• 點選 mask 區塊將會關閉燈箱
• 燈箱右上角需顯示 x，點選後關閉燈箱

點選型錄連結

• 如果是型錄認證燈箱，燈箱區塊中會列出持有該認證的相關型錄，點選後會切換頁面到該型錄的詳目頁