您的資料值得一個計畫 — 關於儲存、格式與成長的思考

大家好，我是 Chae-won。

上次我分享了 3Min API 是如何起步的——那些電話、重複的建構、散落的資料。今天我想聊聊在設計這個服務時，我們花最多時間思考的事情。

資料。

不是像儀表板或即時警報這些看得到的功能，而是安靜但構成一切基礎的東西——你的資料如何被結構化、儲存，以及最終如何被使用。因為如果在早期就弄錯這個部分，後面的一切都會變得更困難。

每家公司儲存資料的方式都不同

我們很早就注意到一件事：我們合作的每家企業，整理資訊的方式都不一樣。物流公司可能用 tracking_number（追蹤號碼）、origin（出發地）、destination（目的地）和 weight（重量）這些欄位來追蹤貨運。電商則關注 order_id（訂單編號）、product_name（商品名稱）、quantity（數量）和 price（價格）。

即使是同一產業的兩家公司，也幾乎不會使用完全相同的結構。他們的資料庫——所有資訊存放的系統——各自有自己的「結構描述（schema）」。你可以把 schema 想成是一份藍圖：它定義了什麼樣的資料放在哪裡、哪些是必填的、應該是什麼格式。

因此，當要透過 API 進行整合時，第一個問題永遠是：「我們如何就資料格式達成共識？」

JSON：共通語言

這就是 JSON 登場的地方。如果你之前沒聽過這個詞，別擔心——從現在起你會經常聽到它，所以值得先了解一下。

JSON 是「JavaScript Object Notation」的縮寫。儘管名字中有 JavaScript，但它跟寫程式碼無關。它只是一種簡單的方式來書寫結構化資料，人類和電腦都能讀懂。

它長這樣：

{
  "company": "日出物流",
  "order_id": "ORD-20260301",
  "items": 12,
  "delivered": true
}

就這樣。大括號、左邊是鍵（key）、右邊是值（value）。它輕量、靈活，而且——最重要的是——它已經成為 API 的通用標準。當兩個系統在網路上互相通訊時，它們很可能就是在用 JSON 交談。

我們選擇 JSON 作為 3Min API 的核心資料格式，正是因為這種普遍性。你的合作夥伴用 JSON 傳送資料，我們用 JSON 儲存，當你之後下載記錄時，你也會拿到 JSON。不需要轉換層，不需要為格式轉換而頭疼。

如果要早點熟悉一個技術概念，就是這個。隨著你的業務成長並與更多合作夥伴整合，API 和 JSON 會一次又一次地出現。

等等——可以直接儲存 JSON 嗎？

好問題。答案是可以的。有些資料庫被設計成可以直接儲存 JSON，不需要先強制轉換成嚴格的行列格式。這類資料庫通常被稱為「文件資料庫」或「NoSQL 資料庫」——MongoDB 大概是最知名的例子。

這基本上就是 3Min API 底層的運作方式。當資料到達你的端點時，我們會將整個 JSON 負載以靈活的文件格式儲存。這意味著你不需要事先定義一個具有固定欄位的傳統資料庫表格。你只需描述你期望接收的資料形狀，剩下的我們來處理。

但它不是萬能的

老實說——以 JSON 格式儲存資料並不適合所有情況。

優點：設定速度快得令人難以置信。你可以在幾分鐘內開始接收資料。如果你的合作夥伴新增了一個欄位，你不需要重建任何東西就能適應。它天生就是靈活的。

缺點：同樣的靈活性如果不小心，也可能成為問題。具有嚴格 schema 的傳統資料庫有一個內建優勢——它們強制保持一致性。每筆記錄看起來都一樣，這使得搜尋、排序和分析資料變得簡單直接。

使用靈活格式時，如果你太頻繁地更改資料結構，最終每筆記錄看起來都會略有不同。有些有 5 個欄位，有些有 8 個。有些用 order_date，有些用 date_ordered。隨著時間推移，這種不一致會讓你的資料越來越難處理——特別是當你之後想要分析它的時候。

實用建議：上線前做好計畫

這就是為什麼我們強烈建議在進入正式環境之前，充分利用沙盒環境。

當你第一次建立端點時，花時間與你的合作夥伴討論資料結構。來回傳送測試資料，確保欄位名稱、類型和整體形狀對雙方都合理。沙盒的存在正是為此——它是一個安全的空間，沒有任何東西是永久的，犯錯也不需要任何成本。

當雙方都確信格式正確後，再部署到正式環境。那裡才是真實資料流動的地方。

如果未來你的資料格式需要大幅更改呢？不要修改現有的端點。建立一個新的。端點數量沒有限制，所以你可以根據業務需要自由建立。這樣，你的歷史資料保持乾淨和一致，而新格式則有一個全新的開始。

更大的格局：你的資料是商業資產

這裡是所有事情串聯在一起的地方。

每一次透過 3Min API 的 API 呼叫都是一筆真實商業交易的記錄——一筆下單的訂單、一次請求的出貨、一個確認的預約。隨著時間推移，這些記錄累積成有價值的東西：一個述說你業務故事的資料集。

這就是我們為什麼打造了封存功能。你可以將資料下載為 JSONL 檔案——每行一筆 JSON 記錄——然後按照你需要的方式使用。

你能用它做什麼？比你想像的更多：

• 在 Excel 或 Google Sheets 中開啟，快速瀏覽概要
• 載入 BI 工具（如 Metabase、Redash 或 Google Looker Studio）來建立儀表板
• 提供給 AI 助手，用自然語言提問
• 交給資料分析師或顧問公司進行專業分析

目標不僅是儲存資料——而是將它轉化為洞察。哪些產品賣得最快？哪些合作夥伴送來最多訂單？是否有可以提前規劃的季節性模式？

當你根據真實資料而非直覺做決策時，你的業務將在更堅實的基礎上成長。改善表現不佳的部分，加倍投入表現良好的部分。當重大決策來臨時——拓展新市場、增加人員、投資新工具——你會有數據來支持。

這就是我們希望每個使用 3Min API 的團隊都能達到的。不僅僅是一條將資料從 A 點搬到 B 點的管道，而是一個幫助你理解和發展業務的基礎。