不用後端,如何建立 API 端點
大家好,我是 Chae-won。
在第一篇文章中,我提到了「我們需要 API 但沒有開發團隊」的情境。今天讓我們更進一步,實際走一遍如何建立 API 端點。
不用寫程式、不用架伺服器,3 分鐘搞定。以下是流程。
等等,什麼是 API 端點?
API 端點就是「傳送和接收資料的地址」。
要收信需要信箱地址。API 端點就是你的數位信箱。當合作夥伴把資料傳送到這個地址時,你就能接收和查看。
通常建立這個「信箱」需要架設伺服器、撰寫程式碼、設計資料庫。這是工程師等級的工作。但用 3Min API,你可以跳過這一切。
步驟一:決定要接收什麼資料
第一件事是決定「我想接收什麼資料?」
假設你想從電商合作夥伴接收訂單資料。你需要的欄位可能是:
{
"order_id": "ORD-001",
"product_name": "無線藍牙耳機",
"quantity": 2,
"price": 1350,
"customer_name": "王小明"
}
決定你需要哪些欄位,以及每個欄位的格式(文字、數字等)。最好跟合作夥伴先討論好。
步驟二:在 3Min API 建立端點
登入 3Min API 儀表板,點擊「建立新端點」。你需要輸入:
- 名稱:有描述性的名稱(例如「A 商店訂單」)
- 欄位定義:接受什麼資料
逐一新增欄位——名稱、類型(文字、數字、日期等)、以及是否為必填。全部透過介面點擊完成。
儲存後,你會立即取得一個 API 網址。這個網址就是你的「數位信箱」。
步驟三:在沙盒中測試
建立端點時,沙盒環境會自動設定好。沙盒是你的「練習場」——可以自由傳送和刪除資料,不會影響正式環境。
把沙盒 API 金鑰(以 tm_test_ 開頭)分享給合作夥伴的開發人員,他們就可以開始傳送測試資料。你可以在儀表板上驗證一切是否正確收到。
在這個階段可以隨意修改或新增欄位。持續調整直到雙方都滿意。
步驟四:部署到正式環境
測試完成後,按下「部署到正式環境」按鈕。這會啟用正式 API 金鑰(以 tm_live_ 開頭),合作夥伴就可以開始傳送真實資料了。
正式資料與沙盒完全隔離。你可以在儀表板上即時監控進入的資料,統計數據也會自動累積。
步驟五:連結 Webhook(選用)
想要進來的資料自動轉發到其他地方?設定 Webhook。例如:
- 轉發資料到你的內部系統
- 傳送通知到 LINE 群組
- 自動記錄到 Google 試算表
只需輸入 Webhook 網址——搞定。每次資料到達時都會自動轉發。
這些全部要多久?
如果你已經跟合作夥伴討論好資料格式,整個過程真的只需大約 3 分鐘。定義欄位 + 建立端點 + 分享測試金鑰。就這樣。
不用架伺服器、不用寫程式碼、不用設計資料庫。不用外包費用,不用等好幾個禮拜。
接下來呢?
如果你的業務成長了,需要更複雜的邏輯,那時候再考慮建構自己的系統。儲存在 3Min API 的資料隨時可以匯出為 JSONL,所以不用擔心資料遺失。
重要的是先開始。今天就讓資料流動起來,比等好幾個禮拜等到完美的系統要好得多。