技術指南

    綠色生活資訊網資料開放系統提供環保標章獲證產品資訊,民眾可在網站或以Open API介接方式取得相關資訊。獲證產品查詢資料均有列出格式及欄位定義,協助開發人員充分了解資料內容或應使用的介接技術,針對較複雜的API,並於系統點擊「使用說明」時即提供相關說明。
    以下針對API的使用方式進行說明。
    一、獲證產品批次查詢:
    • URL:https://greenliving.epa.gov.tw/Public/APIs/ProductsBatch/{status}/{pageIndex}
    • 編碼:UTF-8
    • 傳遞參數格式:JSON
    • 參數說明:
      • status:產品證書狀態。1:有效、2:過期、3:暫停使用、4:註銷(終止使用)、5:註銷(廢止)、6:註銷(撤銷)
      • pageIndex:頁次
    • 參數內容及限制:
      • status:不可忽略
      • pageIndex:每次回傳筆數最多為20筆,可忽略,未填寫預設為1
    • 回傳格式:
      • Result:執行結果。Sussess:成功,Error:失敗
      • Message:執行結果說明。如執行結果失敗,紀錄失敗訊息,反之為空值
      • RowsCount:資料總筆數
      • PageIndex:頁次
      • Detail
        • ShowStatus:產品證書狀態。1:有效、2:過期、3:暫停使用、4:註銷(終止使用)、5:註銷(廢止)、6:註銷(撤銷)
        • NameZH:產品名稱
        • Type:型號
        • SerialType:系統型號
        • CriteriaClass:產品分類
        • CriteriaClassNo:產品分類編號
        • Criteria:規格標準
        • CriteriaNo:規格標準編號
        • Class:產品類別。1:第一類、2:第二類
        • Num:環保標章編號
        • SignDate:生效日
        • ValidDate:到期日
        • CorpName:廠商名稱
        • CorpAddress:公司地址
    二、獲證產品單筆查詢:
    • URL:https://greenliving.epa.gov.tw/Public/APIs/Product/{class}/{num}
    • 編碼:UTF-8
    • 傳遞參數格式:JSON
    • 參數說明:
      • class:產品類別。1:第一類、2:第二類
      • num:環保標章編號
    • 參數內容及限制:
      • class:不可忽略
      • num:不可忽略
    • 回傳格式:
      • Result:執行結果。Sussess:成功,Error:失敗
      • Message:執行結果說明。如執行結果失敗,紀錄失敗訊息,反之為空值
      • RowsCount:資料總筆數
      • PageIndex:頁次
      • Detail
        • ShowStatus:產品證書狀態。1:有效、2:過期、3:暫停使用、4:註銷(終止使用)、5:註銷(廢止)、6:註銷(撤銷)
        • NameZH:產品名稱
        • Type:型號
        • SerialType:系統型號
        • CriteriaClass:產品分類
        • CriteriaClassNo:產品分類編號
        • Criteria:規格標準
        • CriteriaNo:規格標準編號
        • Class:產品類別
        • Num:環保標章編號
        • SignDate:生效日
        • ValidDate:到期日
        • CorpName:廠商名稱
        • CorpAddress:公司地址

    使用說明

    一、獲證產品批次查詢:
    ASP.NET
    var request = WebRequest.Create(URL);
    request.ContentType = "application/json; charset=utf-8";
    var response = (HttpWebResponse)request.GetResponse();
    string result = string.Empty;
    
    using (var sr = new StreamReader(response.GetResponseStream()))
    {
        result = sr.ReadToEnd();
    }
    JavaScript
    $(function () {
        $.ajax({
            url: URL,
            type: "GET",
            dataType: "json",
            success: function (data) {
                alert("成功!");
                console.log(data);
            },
            error: function () {
                alert("失敗!");
            }
        });
    });
    二、獲證產品單筆查詢:
    ASP.NET
    var request = WebRequest.Create(URL);
    request.ContentType = "application/json; charset=utf-8";
    var response = (HttpWebResponse)request.GetResponse();
    string result = string.Empty;
    
    using (var sr = new StreamReader(response.GetResponseStream()))
    {
        result = sr.ReadToEnd();
    }
    JavaScript
    $(function () {
        $.ajax({
            url: URL,
            type: "GET",
            dataType: "json",
            success: function (data) {
                alert("成功!");
                console.log(data);
            },
            error: function () {
                alert("失敗!");
            }
        });
    });

    常見問題

    • 本資料之取得是否免費使用?授權的方式為何?
      本網站開放之資料集以免費為原則,以無償及非專屬授權方式授權使用者得不限時間及地域,重製、改作、編輯、公開傳輸或為其他利用方式,開發各種產品或服務,提供公眾使用,無須取得各資料提供機關之書面或其他方式授權。
    • 為何回傳的參數中文字為亂碼?
      呼叫及返回參數資料採用國際通用編碼格式「UTF-8」,因此使用Open API傳接參數時將編碼調整為「UTF-8」格式即可。
    • 環保標章獲證產品之案件資料會公開民眾查詢嗎?
      一般而言,僅部分產品開放資訊會被看到。一般業者申請環保標章時所提交之申請案件資訊,僅讓驗證單位作為審查之使用,不會開放民眾瀏覽。本網站資料開放系統之產品資訊為一般獲證產品內容,包含產品名稱、型號、系列型號產品分類、規格標準、申請廠商、地址等資訊。