一句話版本
先確認三件事:電腦在公司網、Key 複製完整、AI 真的帶了 X-API-Key。不要一開始就問「全公司今年毛利」。
先確認三件事:電腦在公司網、Key 複製完整、AI 真的帶了 X-API-Key。不要一開始就問「全公司今年毛利」。
最快的測法:讓 AI 自己測
Key 貼進 AI 之後(下一堂會教貼哪裡),先問這句:
請複製這句去問
「請用我的 ERP API Key 打 GET http://192.168.0.40/erp-api/api/health,告訴我回了什麼。」
健康檢查其實不需要 Key 也會通。能回 {"status":"ok"} 代表網路通了。下一步才測 Key 本身:
再問這句
「請帶 X-API-Key,打 GET http://192.168.0.40/erp-api/api/read/items?q=SAS&limit=3,只告訴我成功還是失敗、失敗的狀態碼。」
三種結果,對號入座
200,有資料回來
Key 有效,而且你在鼎新有庫存/品號的查詢權。可以開始問正事。
401 未授權/僅接受 API Key
Key 沒帶上、貼斷了、多了空白、或已經過期/被撤銷。回 Step 2 檢查,必要時重新發放。
403 沒有權限
Key 是好的,但這支資料你在鼎新沒有查詢權。換問你平常在鼎新就看得到的單。下一堂會講這件事。
打不開、timeout、連不上
多半不在公司網。確認網路線/Wi-Fi 是公司的,或先連 VPN。
想自己用瀏覽器看規格
Swagger 在 http://192.168.0.40/erp-api/docs 。這頁給工程師試打用,一般同事不必進去。會用 AI 問,就夠了。
⚠️ 測的時候請用你熟的資料
例如你自己開過的訂單、你倉庫裡的品號。不要一上來查別部門的單價、薪資、完整客戶名單。
測通就好,不要拿來一次拉全公司三年資料。
例如你自己開過的訂單、你倉庫裡的品號。不要一上來查別部門的單價、薪資、完整客戶名單。
測通就好,不要拿來一次拉全公司三年資料。
聖威學院 · 讓 AI 幫你讀 ERP