今日瀏覽人數

共 03093 位訪客

自97年1月1日起

網站第 53175333 位訪客

 

技術指南

綠色生活資訊網資料開放系統提供環保標章獲證產品資訊,民眾可在網站或以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」格式即可。
  • 環保標章獲證產品之案件資料會公開民眾查詢嗎?
    一般而言,僅部分產品開放資訊會被看到。一般業者申請環保標章時所提交之申請案件資訊,僅讓驗證單位作為審查之使用,不會開放民眾瀏覽。本網站資料開放系統之產品資訊為一般獲證產品內容,包含產品名稱、型號、系列型號產品分類、規格標準、申請廠商、地址等資訊。