EDS API 查詢流程文件

1. 通用回應格式 #

所有 EDS API 共用統一的回應信封（基類 Response：success + status + timestamp）。

成功 (SuccessResponse):

{ "success": true, "status": 200, "timestamp": "...", "message": "...", "data": { } }

data 為各 API 的實際內容；列表型 API 的 data 為陣列。

失敗 (ErrorResponse):

{ "success": false, "status": 400, "timestamp": "...", "error": { "code": "err_invalid_param", "message": "..." } }

錯誤碼對照 (EdsErrorCodes):

2. Product Table API #

Endpoint: GET /bin/public/eds/product-table

統一路由 Servlet，根據 table_resource_type 分發到不同 Handler。

公共引數

product_spec_id / product_group_id / evb_id 為三選一且互斥：傳 2 個以上 → 400；一個都不傳 → 400。

路由邏輯

1. 解析來源引數 → 得到 specIds（最多 50 個）
   • 傳 evb_id → 解析 EVB（找不到 → 404），取 evb.resolvedProductSpecs 的 Spec ID；同時保留 evb 物件
   • 傳 product_group_id → 查出該 Group 下所有 ProductSpec ID（Group 找不到或無 Spec → 400）
   • 傳 product_spec_id → 解析逗號分隔列表
2. 分發到 Handler：
   • 由 evb_id 進入（evb != null）→ 呼叫 handler.handleEvb(evb, specIds)
   • 單個 Spec → 呼叫 handler.handle()
   • 多個 Spec → 呼叫 handler.handleMultiple()

三個入口最終都收斂到 specIds，差別在於 evb_id 會走 handleEvb()，讓部分 Handler 做 EVB 專屬處理（詳見下方「入口引數調用鏈路」）。

2.1 Type × 參數支持矩陣 #

兩種引數族（別混用「互斥」一詞）:

1. 入口引數（product_spec_id / product_group_id / evb_id）— 三選一互斥，恰好提供一個，否則 400。決定「查哪些 Spec」。
2. 子表篩選引數（type，僅 design-tools / technical-documentation）— 逗號可多值的「包含篩選」，非互斥；不傳 = 回全部子表；未知值靜默忽略（不報錯）。決定「回哪些子表」。

此外 parameter 有一個 列推導引數 product_category_id（選填）。

怎麼讀這張表: 「✓ / 預設」= 該入口無專屬處理，等同於把解析出的 Spec 當一組來查（演算法見各子節）；粗體 override = 該 Type 對此入口有專屬輸出，務必看對應子節的「入口差異」說明。

2.2 入口引數調用鏈路（group_id / evb_id） #

三種來源引數的解析過程不同，但都會收斂為一組 specIds 再分發。以下說明 product_group_id 與 evb_id 兩條較複雜的鏈路。

product_group_id 鏈路

CF 關係:

查詢流程:

1. ProductSpecService.findAllByProductGroupId(groupId) → ProductGroupRepository.findById(groupId)（Group 不存在 → 回傳空 → 400 No specs found for group）
2. findAllByProductGroup：用 ProductSpecSearchFilter.byProductGroup(group.uuid) 查出該組所有 ProductSpec
3. 取出各 Spec 的 ID 組成 specIds，再按單個 / 多個分發到 handle() / handleMultiple()

簡單說：group_id 只是「展開為該組的所有 Spec」，展開後與直接傳 product_spec_id 多個值的行為一致。

請求示例:

GET /bin/public/eds/product-table?table_resource_type=ordering-products&product_group_id=<groupId>&lang=en

evb_id 鏈路

CF 關係:

查詢流程:

1. EvaluationBoardService.findByIdWithResolvedSpecs(evbId) 解析 EVB（找不到 → 404 Evaluation board not found）
2. 從 evb.getResolvedProductSpecs() 取出 Spec ID 組成 specIds（可能為空）
3. 因 evb != null，呼叫 handler.handleEvb(evb, specIds) —— 各 Handler 行為不同：

簡單說：evb_id 先解析 EVB → 拿到關聯 Spec；多數表把它當成「一組 Spec」處理，parameter、evb、technical-documentation 三張表則針對 EVB 做了專屬輸出。

請求示例:

# EVB 表：只顯示這塊 EVB
GET /bin/public/eds/product-table?table_resource_type=evb&evb_id=<evbId>&lang=en

# 技術文件：EVB 入口只回傳 3 個子表
GET /bin/public/eds/product-table?table_resource_type=technical-documentation&evb_id=<evbId>&lang=en

# 參數表：EVB 入口 = 用關聯 Spec 進入，PRODUCT_NUMBER 渲染為可跳轉連結（同 Product Group）
GET /bin/public/eds/product-table?table_resource_type=parameter&evb_id=<evbId>&lang=en

2.3 Parameter Table #

table_resource_type=parameter

額外引數: product_category_id（可選，列推導用）

入口差異（Parameter 表獨有）: 本表會根據「是否經 product_group_id 或 evb_id 進入」改變輸出 —— 這兩種入口會把 PRODUCT_NUMBER 列變成連結；只有單純 product_spec_id 入口維持純文字。

CF 關係

product_category_id 推導邏輯

查詢流程

1. 推導 category_id：按上述邏輯確定有效的葉子 category_id
2. 用 category_id 查所有 ProductParameter → 決定表格有哪些列（引數名、型別、單位）
3. 用 product_spec_id 查所有 ProductFamily → 決定表格有哪些行（每個 Family = 一個產品型號）
4. 解析每個 Family 的 specificParams JSON，對映到對應引數列
5. 補上固定列（PRODUCT_NUMBER、DATASHEET、STATUS），去掉空列
6. 計算高亮標記（值不同的列標記為 highlight），重新排序列：固定列 → 高亮列 → 普通列
7. 根據 Spec 的 updateDay 判斷 is_new（一年內為 true）

Product Group / EVB 入口的 PRODUCT_NUMBER 連結

PRODUCT_NUMBER 列預設是純文字（Family 名稱）。當請求經 product_group_id 或 evb_id 進入時，該列才會變成指向各自 Spec 頁面的文字連結。兩條入口觸發連結的機制略有不同：

1. group 入口：isGroupEntry(request) = 帶 product_group_id 即為 true（後端以「請求是否帶 product_group_id 引數」判定，不看解析後的 Spec 數量 —— 一個只含單一 Spec 的 Group 仍走 group 入口）。handle() / handleMultiple() 據此開啟連結。
2. evb 入口：handleEvb() 直接以 linkProductNumber=true 委派，視為與 group 入口一致的跨 Spec 聚合檢視，永遠開啟連結。
3. 連結組裝：buildSpecPagePathMap 一次批次查詢解析所有 specId → Spec 頁面 contentPath（無對應頁面的 Spec 不出現在 map 中，該行退回純文字）。
4. 若同時帶 product_category_id，會把它作為 query 參數拼到目標頁 URL（?product_category_id=...），讓落地的 Spec 頁保留瀏覽分類上下文。

換言之：product_spec_id 入口 → PRODUCT_NUMBER 純文字；product_group_id / evb_id 入口 → PRODUCT_NUMBER 連結（指向 Spec 頁，帶分類上下文）。

請求示例

# 單 Spec + 顯式 category_id
GET /bin/public/eds/product-table?table_resource_type=parameter&product_spec_id=RT2101A&product_category_id=73C2EB1D-41CC-4D10-A6FF-F3959913DA7C&lang=en

# 多 Spec，不傳 category_id（自動推導）
GET /bin/public/eds/product-table?table_resource_type=parameter&product_spec_id=RT2101A,RT2101B&lang=en

資料流拆解

2.4 Package Size Pins Size Table #

table_resource_type=package-size-pins-size

本表引數: 無額外引數。三個入口（spec / group / evb）皆走預設行為 —— 把解析出的 Spec 當一組查 Family，無 EVB 專屬輸出。

CF 關係

查詢流程

1. 用 product_spec_id 查所有 ProductFamily
2. 從每個 Family 查所有 Product，解析其 package 引用
3. 批次載入 Package 及其 PackageCategory
4. 按 Package 分組，每個 Package 行包含：
   • PACKAGE_TYPE（PackageCategory 名稱）
   • PACKAGE_NAME（Package 名稱）
   • PINS（引腳數）
   • Outline Dimension PDF、Footprint 檔案、Package Image、3D Model
5. 掃描 DAM 資料夾 (/content/dam/richtek-eds/resources/packages/{packageId}/) 獲取關聯檔案

請求示例

GET /bin/public/eds/product-table?table_resource_type=package-size-pins-size&product_spec_id=RT2101A&lang=en

資料流拆解

2.5 Ordering Products Table #

table_resource_type=ordering-products

別名: table_resource_type=products 會被後端對映到 ordering-products（向後相容）。

本表引數: 無額外引數。三個入口（spec / group / evb）皆走預設行為，無 EVB 專屬輸出。

CF 關係

查詢流程

1. 用 product_spec_id 查所有 ProductFamily
2. 從每個 Family 查所有 Product
3. 批次解析每個 Product 的引用：Package、ProductStock、Distributor
4. 組裝每行資料：
   • PRODUCT_NUMBER（Product 名稱）
   • PACKAGE_TYPE（PackageCategory 名稱）
   • PACKAGE_NAME（Package 名稱）
   • STATUS（Family 狀態對映）
   • MOQ（最小訂購量）
   • STOCK（庫存狀態）
   • DISTRIBUTOR（經銷商連結列表）

請求示例

GET /bin/public/eds/product-table?table_resource_type=ordering-products&product_spec_id=RT2101A&lang=en

資料流拆解

2.6 EVB Table #

table_resource_type=evb

evb_id 入口（override）: 經 evb_id 進入時走 handleEvb()，只顯示所請求的這塊 EVB 本身，不會展開關聯 Spec 的其他兄弟 EVB；經 product_spec_id / product_group_id 進入則顯示 Spec 關聯的所有 EVB。詳見「入口引數調用鏈路」。

本表引數: 無額外引數（差異全在入口：見上方 override 說明）。

CF 關係

查詢流程

1. 用 product_spec_id 查所有 EvaluationBoard
2. 批次載入 EvbStock 和 Distributor
3. 組裝每行資料：
   • EVB_NAME（評估板名稱）
   • STOCK（庫存狀態）
   • DISTRIBUTOR（經銷商連結列表）

請求示例

GET /bin/public/eds/product-table?table_resource_type=evb&product_spec_id=RT2101A&lang=en

資料流拆解

2.7 Design Tools Table #

table_resource_type=design-tools

額外引數: type（可選，子表篩選）

入口行為: 三個入口（spec / group / evb）皆走預設行為，無 EVB 專屬輸出 —— evb_id 進入 = 用 EVB 關聯 Spec 查 packages / downloads。

CF 關係

查詢流程

packages 表：

1. 從 Spec → Family → Product → Package，與 Package Size Pins Size 相同
2. 返回封裝相關檔案（Outline Dimension、Footprint、3D Model）

downloads 表：

1. 通過 TechdocLinker 查詢該 Spec 關聯的設計工具下載連結
2. 返回工具名稱和下載 URL

請求示例

GET /bin/public/eds/product-table?table_resource_type=design-tools&product_spec_id=RT2101A&lang=en
GET /bin/public/eds/product-table?table_resource_type=design-tools&product_spec_id=RT2101A&type=downloads&lang=en

2.8 Technical Documentation Table #

table_resource_type=technical-documentation

evb_id 入口（override）: 經 evb_id 進入時走 handleEvb()，只回傳 3 個子表（design_support_kit、evaluation_boards、product_introduction），type 引數在這 3 者內收窄；經 product_spec_id / product_group_id 進入則回傳下方完整 6 類子表。詳見「入口引數調用鏈路」。

額外引數: type（可選，子表篩選）

CF 關係

查詢流程

按文件類別返回多個子表，每個子表有獨立的列和資料：

1. Datasheet — 查 ProductFamily，提取 Datasheet PDF 連結
2. Application Note — 通過 TechdocLinker 查關聯的應用筆記
3. Selection Guide — 通過 TechdocLinker 查選型指南
4. Design Support Kit — 通過 TechdocLinker 查設計支援包
5. Evaluation Boards — 查 EvaluationBoard CF 列表
6. Product Introduction — 通過 TechdocLinker 查產品介紹

請求示例

GET /bin/public/eds/product-table?table_resource_type=technical-documentation&product_spec_id=RT5760A&lang=en
GET /bin/public/eds/product-table?table_resource_type=technical-documentation&product_spec_id=RT5760A&type=datasheet&lang=en

資料流拆解 (datasheet 子表)

3. Parametric Search API #

3.1 Parametric Search #

Endpoint: GET /bin/public/eds/parametric-search

CF 關係

查詢流程

1. 載入給定 Category 及其所有子類別（樹展開）
2. 從給定 Category 載入 ProductParameter（列定義）
3. 從所有類別收集關聯的 ProductSpec UUID
4. 一次批次查詢所有 Spec 的 ProductFamily
5. 預解析所有 Family 的 specificParams JSON 並快取
6. 構建行資料 → 應用篩選條件 → 關鍵詞搜尋 → 排序 → 分頁返回

請求示例

# 基礎查詢: Switching Regulators > Step-Down (Buck) > Converters > Vin < 8V
GET /bin/public/eds/parametric-search?product_category_id=73C2EB1D-41CC-4D10-A6FF-F3959913DA7C&lang=en&page=1&page_size=20

# 帶篩選: 只看 Active 且 VIN_MIN 在 2.5~5V 範圍
GET /bin/public/eds/parametric-search?product_category_id=73C2EB1D-41CC-4D10-A6FF-F3959913DA7C&filter.STATUS.values=Active&filter.VIN_MIN.min=2.5&filter.VIN_MIN.max=5&lang=en

# 帶關鍵詞搜尋 + 排序
GET /bin/public/eds/parametric-search?product_category_id=73C2EB1D-41CC-4D10-A6FF-F3959913DA7C&keyword=RT2101&sort_by=IOUT_MAX&sort_order=desc&lang=en

資料流拆解 (以 "Vin < 8V" 類別為例)

3.2 Parametric Search Filters #

Endpoint: GET /bin/public/eds/parametric-search/filters

查詢流程

1. 與 Parametric Search 共享 loadParametricData() 載入邏輯
2. 構建 STATUS 篩選器（Active / NRND / LTB / EOL）
3. 構建動態引數篩選器：
   • RANGE_VALUE_SLIDER → 從快取值中計算 min/max
   • CHECKBOX → 收集所有不同的字串值

請求示例

GET /bin/public/eds/parametric-search/filters?product_category_id=73C2EB1D-41CC-4D10-A6FF-F3959913DA7C&lang=en

返回示例

{
  "filters": [
    { "name": "STATUS", "type": "CHECKBOX", "options": ["Active", "NRND", "LTB", "EOL"] },
    { "name": "VIN_MIN", "type": "RANGE_VALUE_SLIDER", "unit": "V", "min": 1.5, "max": 7.5 },
    { "name": "IOUT_MAX", "type": "RANGE_VALUE_SLIDER", "unit": "A", "min": 0.5, "max": 12 },
    { "name": "ADJUSTABLE", "type": "CHECKBOX", "options": ["Resistor", "Fixed"] },
    { "name": "PACKAGE_TYPE", "type": "CHECKBOX", "options": ["WQFN3x3-16", "WDFN2x2-6", "SOP-8"] }
  ]
}

3.3 Compare Products #

Endpoint: GET /bin/public/eds/compare-products

pn / product_spec_id / product_group_id / evb_id 四選一互斥，恰好提供一個。

CF 關係: 與 Parametric Search 相同。

查詢流程

依「入口來源」分資料載入路徑，之後合流：

A. pn + product_category_id（共用 loadParametricData）:

1. 與 Parametric Search 步驟 1~5 完全相同（展開 Category 樹 → 收集 Spec → 批次載入 Family（僅 Active）→ 預解析 specificParams）

B. pn 無 product_category_id（loadParametricDataByProductNumbers，全局解析）:

1. 用 ProductFamilySearchFilter.byNames(pn) 全局查 Family（不限分類子樹），僅保留 Active
2. 解析各 Family 的 Spec，收集每個 Spec 直接關聯的葉子分類 UUID
3. 沿祖先鏈展開（葉子 + 祖先），union（聯集）所有層級的參數作為列（與 Cross Reference 共用 CategoryHierarchyHelper）
4. 預解析 specificParams

C. product_spec_id / product_group_id / evb_id（compareBySpecs）:

1. 將來源解析為一組 Spec UUID（spec → 自身；group → findAllByProductGroupId；evb → EvaluationBoard.getProductSpecs()），用 ProductFamilySearchFilter.byProductSpecs 查 Family，僅保留 Active，依 Product Number 升序
2. 列：帶 product_category_id 取該分類參數，否則取這些 Family 所屬分類的聯集（同 B 的 deriveUnionParameters）；無 not_found

合流後:

• A / B：在記憶體中依 pn 挑選對應 Family（保持請求順序、不區分大小寫、重複合併），找不到的 pn 收集至 not_found
• 全部入口：buildColumns（含 STATUS；compare 顯示 hidden=true 參數，列不標 hidden flag，與 parametric-search 不同）→ 對選中子集解析 PRODUCT_NUMBER 連結（3 個批次查詢）→ 逐筆組裝行

請求示例

# pn + 分類上下文（從參數搜尋頁勾選比較）
GET /bin/public/eds/compare-products?product_category_id=242909&pn=RT2101A&pn=RT2101B&lang=en
# pn 無分類（從 Cross Reference 跳轉，按 pn 全局解析）
GET /bin/public/eds/compare-products?pn=RT2101A&pn=RT2101B&lang=en
# spec / group / evb 入口（可再加 &product_category_id=...）
GET /bin/public/eds/compare-products?product_spec_id=RT9101,RT9119&lang=en
GET /bin/public/eds/compare-products?product_group_id=RT9101&lang=en
GET /bin/public/eds/compare-products?evb_id=EVB_RT6166DP-A&lang=en

返回: 與 Parametric Search 同契約（table_name="compare-products" / columns / products），無 pagination；not_found 僅 pn 入口可能出現（全部解析成功時省略）。前端比較頁自行轉置渲染：第一行 = 各 PRODUCT_NUMBER.name + DATASHEET，左側標籤欄 = columns[].field_name (+unit)。

4. Cross Reference Search API #

4.1 Cross Reference Search #

Endpoint: GET /bin/public/eds/cross-reference-search

CF 關係

Spec 連的是葉子 Category，但 ProductParameter 掛在上層（祖先） Category 上，所以必須沿 parent 向上展開後再收集引數。

查詢流程

1. 用 keyword OR 搜尋 CrossReference（匹配 id 或 company_name，LIKE 轉義）
2. 從匹配的 CrossReference 解析出關聯的 ProductSpec
3. 構建 specUuid → typeOfMatch 對映（去重）
4. 收集每個 Spec 的葉子類別 → 沿 parent 向上展開到所有祖先類別 → 計算引數並集（按 name 去重保留第一個、按 order 排序）
5. 批次載入所有 ProductFamily
6. 預解析 specificParams JSON
7. 為每個 Family 根據 typeOfMatch 集合展開行（一個 Family 可能對應多行）
8. 固定列順序為 PRODUCT_NUMBER、DATASHEET、TYPE_OF_MATCH（TYPE_OF_MATCH 為第 3 列），其後接動態引數列
9. 應用篩選 → 排序 → 分頁

注意：有哪些列由「葉子+祖先類別的引數並集」決定，與 Family 是否有值無關（引數有定義即出列，無值則該格留空）；Family 的 specificParams 只用於填值與計算 filter 選項/範圍。

請求示例

# 搜尋競品型號
GET /bin/public/eds/cross-reference-search?keyword=TPS51125&lang=en&page=1&page_size=20

# 搜尋競品公司
GET /bin/public/eds/cross-reference-search?keyword=Texas&lang=en

資料流拆解

4.2 Cross Reference Search Filters #

Endpoint: GET /bin/public/eds/cross-reference-search/filters

查詢流程: 與 Cross Reference Search 共享資料載入，返回可用的篩選條件定義。

請求示例

GET /bin/public/eds/cross-reference-search/filters?keyword=TPS51125&lang=en

5. Drawing Dimension API #

Endpoint: GET /bin/public/eds/drawing-dimension

CF 關係

查詢流程

1. 載入所有 Package 和 PackageCategory
2. 批次解析 Package 的 packageCategory UUID 引用（零額外查詢）
3. 先應用 keyword 篩選 → 作為篩選器計算的基礎
4. 計算 PINS 篩選範圍（min/max）
5. 構建 PACKAGE_TYPE 篩選器（兩層樹結構 + 計數）
6. 應用 PINS 篩選 → 計算各篩選項數量
7. 應用 PACKAGE_TYPE 篩選 → 最終結果
8. 排序 → 分頁
9. 掃描 DAM 資料夾獲取關聯檔案（Outline Dimension PDF、Footprint、Package Image、3D Model）

請求示例

# 基礎查詢
GET /bin/public/eds/drawing-dimension?lang=en&page=1&page_size=20&sort_by=PINS&sort_order=asc

# 帶篩選: 引腳數 6~16，只看 QFN 型別
GET /bin/public/eds/drawing-dimension?filter.PINS.min=6&filter.PINS.max=16&filter.PACKAGE_TYPE.values=QFN&lang=en

# 關鍵詞搜尋
GET /bin/public/eds/drawing-dimension?keyword=WQFN&lang=en

資料流拆解

6. Product Categories API #

Endpoint: GET /bin/public/eds/product-categories

CF 關係

查詢流程

1. 若傳 id，載入指定 Category 為根節點；否則載入所有根節點
2. 遞迴構建子樹（受 depth 限制）
3. 判斷節點型別：有子節點 → "list"，葉子節點 → "entry"
4. 附加頁面路徑資訊

請求示例

# 獲取完整分類樹
GET /bin/public/eds/product-categories?lang=en&depth=3

# 獲取 Switching Regulators 子樹
GET /bin/public/eds/product-categories?id=EBD6A32C-4264-4153-8D5D-740F5D9A9C2E&lang=en

資料流拆解 (Switching Regulators 子樹)

7. Application Categories API #

Endpoint: GET /bin/public/eds/application-categories

CF 關係

查詢流程

1. 若傳 path，定位到該頁面對應的 ApplicationCategory 子樹
2. 遞迴構建層級結構
3. 每個節點包含：id、title、path、type (list/entry)、pageType、subtitle、description

請求示例

# 完整應用分類樹
GET /bin/public/eds/application-categories?lang=en

# 指定子樹
GET /bin/public/eds/application-categories?path=/content/richtek-eds/en/applications/industrial-control&lang=en

8. New Products API #

Endpoint: GET /bin/public/eds/new-products

CF 關係

查詢流程

1. 查詢 updateDay 在指定月份範圍內的所有 ProductSpec
2. 按頂層 ProductCategory 分組
3. 附加關聯頁面路徑
4. 返回按類別分組的新產品列表

請求示例

GET /bin/public/eds/new-products?months=6&lang=en

返回結構示例

{
  "data": [
    {
      "category_id": "EBD6A32C-4264-4153-8D5D-740F5D9A9C2E",
      "category_name": "Switching Regulators",
      "products": [
        { "id": "RT2101A", "name": "RT2101A", "subtitle": "2.95V to 6V Input, 3A Output...", "page_link": "/content/richtek-eds/en/products/..." },
        { "id": "RT5760A", "name": "RT5760A", "subtitle": "...", "page_link": "..." }
      ]
    },
    {
      "category_id": "48083B19-DAA6-402B-8B92-BEE0292EAD11",
      "category_name": "Linear Regulators",
      "products": [...]
    }
  ]
}

9. Home Page Explore Products API #

Endpoint: GET /bin/public/eds/home-page-explore-products

CF 關係

查詢流程

1. 查詢所有 L1 ApplicationCategory（頂層應用類別）
2. 為每個 L1 類別載入 L2 子類別作為側邊選單
3. 每個類別返回：description、learn-more 連結、佔位圖 URL、L2 子類別列表

請求示例

GET /bin/public/eds/home-page-explore-products?lang=en

10. Product Spec Data API #

Endpoint: GET /bin/public/eds/data/product-specs

CF 關係

查詢流程

1. 載入 ProductSpec
2. 根據 updateDay 判斷 is_new（一年內）
3. 通過 ProductFamily 計算統一狀態（Active/NRND/EOL/多種狀態）
4. 載入該 Spec 的所有 EvaluationBoard
5. 載入 EVB 關聯頁面，從頁面中提取 rtk-image-switcher 元件的圖片
6. 掃描該 Spec 的 Product Data Sheet PDF 資料夾（product-data-sheets/pdf）：存在具 original rendition 的 DAM Asset 時 has_downloadable_documents = true
7. 返回：name、subtitle、is_new、status、has_downloadable_documents、evb_images

請求示例

GET /bin/public/eds/data/product-specs?id=RT2101A&lang=en

返回示例

{
  "data": {
    "name": "RT2101A",
    "subtitle": "2.95V to 6V Input, 3A Output, 2MHz, Synchronous Step-Down Converter",
    "is_new": true,
    "status": "Active",
    "has_downloadable_documents": true,
    "evb_images": [
      { "url": "/content/dam/richtek/...", "alt": "RT2101A-EVB Top View" }
    ]
  }
}

11. Product Group Data API #

Endpoint: GET /bin/public/eds/data/product-groups

CF 關係

查詢流程

1. 載入該 Group 下所有 ProductSpec
2. 判斷 is_new（任一 Spec 的 updateDay 在一年內即為 true）
3. 計算統一狀態（多個 Spec 狀態不同時顯示 "See Product Status"）
4. 載入所有 ProductSpecPage，提取三類圖片：
   • orderbanner_images（橫幅圖片）
   • product_images（產品圖片）
   • evb_images（評估板圖片）
5. 載入 EvaluationBoard + EvbPage，提取額外 EVB 圖片
6. 提取 Spec 頁面上的 ordering 詳細資訊
7. 掃描群組下各 Spec 的 Product Data Sheet PDF 資料夾：任一存在具 original rendition 的可下載 DAM Asset 時 has_downloadable_documents = true

請求示例

GET /bin/public/eds/data/product-groups?id=RT2101&lang=en

資料流拆解

12. Product Category Data API #

Endpoint: GET /bin/public/eds/data/product-categories

查詢流程

• 傳 id：返回單個 ProductCategory 詳情
• 不傳 id：返回所有 ProductCategory 列表

請求示例

# 獲取單個
GET /bin/public/eds/data/product-categories?id=EBD6A32C-4264-4153-8D5D-740F5D9A9C2E&lang=en
# 返回: { id: "EBD6A32C...", name: "Switching Regulators", subtitle: "..." }

# 獲取全部
GET /bin/public/eds/data/product-categories?lang=zh_cn
# 返回: [{ id: "C23F2050...", name: "交流-直流轉換" }, { id: "807A37F0...", name: "放大器" }, ...]

13. EVB Data API #

Endpoint: GET /bin/public/eds/data/evaluation-boards

CF 關係

查詢流程

1. 用 id 載入 EvaluationBoard（找不到 → 404）
2. 解析該 EVB 關聯的所有 ProductSpec（resolveProductSpecs）
3. 批次載入各 Spec 的頁面，提取產品圖片
4. 掃描該 EVB 的 documents 資料夾：存在具 original rendition 的 DAM Asset 時 has_downloadable_documents = true
5. 返回：status、title、has_downloadable_documents、specs[]（id + title）、product_images[]（img + image-alt + title + description）

請求示例

GET /bin/public/eds/data/evaluation-boards?id=EVB-RT2101A&lang=en

返回示例

{
  "data": {
    "status": "Active",
    "title": "EVB-RT2101A",
    "has_downloadable_documents": true,
    "specs": [ { "id": "RT2101A", "title": "RT2101A" } ],
    "product_images": [
      { "img": "/content/dam/richtek/...", "image-alt": "...", "title": "...", "description": "..." }
    ]
  }
}

14. News Data API #

Endpoint: GET /bin/public/eds/data/news

資料根: News 屬於 Tech Insights，CF 位於 /content/dam/richtek-eds/data，與產品資料根 /content/dam/richtek/data 不同。

查詢流程

1. 用 id 載入 News CF（找不到 → 404）
2. 映射 CF 欄位為回應（日期格式化為 yyyy-MM-dd，空值回退為空字串 / 空陣列）

回應欄位: id、title、date、author、card_image、tag_list[]、product_specs[]、evaluation_boards[]

請求示例

GET /bin/public/eds/data/news?id=<newsId>&lang=en

15. Video Data API #

Endpoint: GET /bin/public/eds/data/video

資料根: Video 同屬 Tech Insights，CF 位於 /content/dam/richtek-eds/data。

查詢流程

1. 用 id 載入 Video CF（找不到 → 404）
2. 映射 CF 欄位為回應（同 News，多一個 video_duration）

回應欄位: id、title、date、video_duration、card_image、tag_list[]、product_specs[]、evaluation_boards[]

請求示例

GET /bin/public/eds/data/video?id=<videoId>&lang=en

16. Webinar Data API #

Endpoint: GET /bin/public/eds/data/webinar

資料根: Webinar 同屬 Tech Insights（News / Video / Webinar），CF 位於 /content/dam/richtek-eds/data，與產品資料根 /content/dam/richtek/data 不同。

查詢流程

1. 用 id 載入 Webinar CF（找不到 → 404，訊息 "Resource 'Webinar: {id}' does not exist."）
2. 映射 CF 欄位為回應（日期格式化為 yyyy-MM-dd，空值回退為空字串 / 空陣列）
3. 不展開關聯: product_specs / evaluation_boards 僅返回 CF 中保存的原始 UUID 陣列，不解析名稱或頁面路徑

回應欄位: id、title（取 CF name）、date、card_image、tag_list[]、product_specs[]、evaluation_boards[]

請求示例

GET /bin/public/eds/data/webinar?id=<webinarId>&lang=en

17. Application Note Data API #

Endpoint: GET /bin/public/eds/data/application-note

資料根: Application Note 屬產品資料，CF 與 PDF 位於 /content/dam/richtek/data/{lang}/resources/application-notes/{id}（與 Tech Insights 的 richtek-eds 根不同）。

CF 關係

查詢流程

1. 用 id 載入 ApplicationNote CF（找不到 → 404，訊息 "Resource 'Application note: {id}' does not exist."）
2. 掃描該 AN 的 pdf 資料夾（.../application-notes/{id}/pdf）：存在至少一個具 original rendition 的 DAM Asset 時 has_downloadable_documents = true（不返回檔案清單）
3. 不展開關聯: product_specs 僅返回 CF 中保存的原始 UUID 陣列，不解析名稱或頁面路徑
4. 字串欄位缺值時回退為空字串 ""，陣列欄位缺值時回退為空陣列

回應欄位: id、title、title_en、date（yyyy-MM-dd）、author、product_specs[]、has_downloadable_documents

請求示例

GET /bin/public/eds/data/application-note?id=<applicationNoteId>&lang=en

18. Parametric Search Categories API #

Endpoint: GET /bin/public/eds/parametric-search-categories

CF 關係

查詢流程

1. 校驗 depth（超出 1-10 → 400）
2. 遞迴構建 ProductCategory 樹（與 Product Categories API 同一 ProductCategoriesData 結構：id / title / description / type(list|entry) / url / list[]）
3. 差異: 每個節點的 url 指向參數搜尋頁內容路徑（而非一般 Spec / 分類頁），供參數搜尋頁的分類導覽使用

請求示例

GET /bin/public/eds/parametric-search-categories?depth=1&lang=zh_tw

19. Block APIs #

19.1 Navigation List / Side Menu #

Endpoints:

• GET /bin/public/eds/blocks/navigation-list
• GET /bin/public/eds/blocks/side-menu

查詢流程

1. 根據 section 構建完整 JCR 路徑：/content/richtek-eds/{lang}/{section}
2. 通過 PageManager 獲取根頁面
3. 遞迴遍歷子頁面，構建層級樹
4. 節點型別標註：有子節點 → "list"，葉子 → "entry"

請求示例

GET /bin/public/eds/blocks/navigation-list?section=about-richtek&lang=en
GET /bin/public/eds/blocks/side-menu?section=browse-quality-reliability&lang=en

19.2 Diagram Menu #

Endpoint: GET /bin/public/eds/blocks/diagram-menu

CF 關係

查詢流程

1. 批次載入 ProductSpec 和 ProductSpecPage
2. 對每個 Spec：
   • 計算統一狀態，過濾掉 NRND 和 EOL
   • 獲取購買連結、Datasheet 連結
   • 判斷 is_new
   • 獲取第一個關聯的 ProductCategory ID
3. 返回有效 SpecItem 列表 + 被排除的 ID 列表

請求示例

GET /bin/public/eds/blocks/diagram-menu?id=RT2101A&id=RT5760A&id=RT5760B&lang=en

資料流拆解

19.3 Related Products #

Endpoint: GET /bin/public/eds/blocks/related-products

CF 關係

查詢流程

1. 批次載入 ProductSpec 和 ProductSpecPage
2. 載入分類並查詢祖先節點
3. 對每個 Spec：
   • 檢查 DAM 中是否有卡片圖片
   • 若無 → 沿 Spec → Family → Product → Package → images 資料夾查詢第一張圖
   • 無圖則跳過該 Spec
   • 判斷 is_new
   • 獲取頂層分類（最多 2 個）
   • 獲取購買連結、Datasheet 連結

請求示例

GET /bin/public/eds/blocks/related-products?id=RT2101A&id=RT5760A&lang=en

卡片圖片回退邏輯

19.4 New Products Card #

Endpoint: GET /bin/public/eds/blocks/new-products-card

CF 關係

查詢流程

1. 若傳 categoryId：展開類別樹，收集所有後代 UUID
2. 查詢指定月份內更新的 ProductSpec
3. 記憶體中按類別 UUID 集合篩選
4. 載入 ProductSpecPage
5. 兩階段卡片圖片解析：
   • Phase 1：從 SpecPage 獲取卡片圖片（零額外查詢）
   • Phase 2：批次載入 Family → Product → Package 鏈，從 Package 圖片資料夾查詢
6. 應用數量限制
7. 返回新產品卡片列表

請求示例

# 指定 Switching Regulators 類別下最近 6 個月的新產品，最多 10 個
GET /bin/public/eds/blocks/new-products-card?categoryId=EBD6A32C-4264-4153-8D5D-740F5D9A9C2E&months=6&limit=10&lang=en

# 全部新產品
GET /bin/public/eds/blocks/new-products-card?scope=all&months=12&lang=en

19.5 Tech Insight #

Endpoint: GET /bin/public/eds/blocks/tech-insight

CF 關係

查詢流程（按 scope）

scope=all：

1. 查詢最近 12 個月的 News、Video、Webinar
2. 合併、去重(按 tag:id)、按日期倒序排列

scope=product_category：

1. 展開 Category 樹，收集所有 ProductSpec UUID
2. 分批（每批 100）查詢關聯的 News/Video/Webinar
3. 去重、排序

scope=application_category：

1. 查詢 ApplicationCategory 及其後代
2. 從 Application CF 中提取 ProductSpec UUID
3. 查詢關聯的 News/Video/Webinar
4. 去重、排序

請求示例

# 首頁: 全部 Tech Insight
GET /bin/public/eds/blocks/tech-insight?scope=all&lang=en

# 產品分類頁: Switching Regulators 相關
GET /bin/public/eds/blocks/tech-insight?scope=product_category&category_id=EBD6A32C-4264-4153-8D5D-740F5D9A9C2E&lang=en

# 應用分類頁
GET /bin/public/eds/blocks/tech-insight?scope=application_category&category_id=industrial-control&lang=en

19.6 Tech Insight By Page (舊版) #

Endpoint: GET /bin/public/eds/blocks/tech-insight-by-page

舊版頁面級查詢，保留用於 Application 頁面的 block diagram 元件關聯查詢。新程式碼應優先使用 tech-insight 的 scope=application_category。

查詢流程

1. 查詢 Application Category 頁面及其子頁面
2. 遞迴遍歷所有 rtk-block-diagram-menu 元件節點（支援多個 diagram）
3. 收集元件 items 中的 Spec ID
4. 解析 Spec ID 為 ProductSpec UUID
5. 用 UUID 批次查詢關聯的 News/Video/Webinar
6. 去重、按日期倒序排列

請求示例

GET /bin/public/eds/blocks/tech-insight-by-page?category_id=industrial-control&lang=en

19.7 Tag List #

Endpoint: GET /bin/public/eds/blocks/tag-list

查詢流程

1. 接收頁面路徑陣列
2. 獲取每個頁面的標籤資訊
3. 返回 TagInfo 列表

請求示例

GET /bin/public/eds/blocks/tag-list?page_paths=/content/richtek-eds/en/products/switching-regulators&page_paths=/content/richtek-eds/en/products/linear-regulators&lang=en

19.8 Related / Read More #

Endpoint: GET /bin/public/eds/blocks/related-read-more

Tech Insight 頁（News / Video / Webinar）底部的「Related」與「Read More」兩區內容。

查詢流程

1. 校驗 source_type（轉 TechInsightContentType，非法 → 400）與 source_id（含路徑穿越校驗）
2. 解析兩區的 limit（負值/超限 → 收斂到預設 5 / 上限 20）與 exclude 清單
3. RelatedReadMoreService.findItems 分別計算 Related 與 Read More 兩組項目
4. 返回 related 與 read_more 兩區，每區為 items[]，每個 item = id / name / url

返回示例

{
  "data": {
    "related":   { "items": [ { "id": "...", "name": "...", "url": "..." } ] },
    "read_more": { "items": [ { "id": "...", "name": "...", "url": "..." } ] }
  }
}

請求示例

GET /bin/public/eds/blocks/related-read-more?source_type=news&source_id=<newsId>&related_limit=4&lang=en

20. 附錄: 真實資料參考 #

20.1 頂層產品分類 (L1) #

20.2 分類層級示例 (Switching Regulators) #

20.3 產品引數定義示例 (Vin < 8V 類別) #

20.4 產品狀態值 #