訂單:你要什麼(請求)
……(還沒點)
送回:結果在這(回應)
……(還沒做好)
BOBA BAR
官方點餐 App
歡迎回來
先看看今天有什麼
/menu拿菜單:現在有什麼可點/orders下單:送出一筆新訂單/orders/42查單:42 號做好了沒/reviews評分:幫這一單打星星還沒有任何呼叫。在左邊的 App 按「看菜單」,看它背後打了哪一條端點。
畫面上的每一塊,都是左邊那包 JSON 裡挖出來的某個值。點點看,兩邊會互相對亮。
回應.飲料.品項字串(帶引號的文字):要挖深一層的值,就一層一層點進去:先進「飲料」這包,再拿「品項」。畫面最大那行字就是它。
想查店家「現在開著沒」,Google 提供的服務叫 Places API。第一步:到 GCP 的 API 程式庫把它啟用,等於告訴 Google「我的專案要用這支 API」。
查詢地點資訊:店名、地址、評分、營業時間(含「現在營業中嗎」)。
點下面的品牌磚逛一圈:看每家在做什麼生意、憑證去哪拿、菜單上有哪幾條端點。
把 ChatGPT 的腦袋接進你的 App:對話、生圖、聽打全都是端點。
/v1/chat/completions丟對話訊息進去,拿 AI 回覆回來(ChatGPT 同款能力)
/v1/images/generations一句描述,生一張圖
/v1/audio/transcriptions上傳錄音檔,回逐字稿
platform.openai.com從一杯珍奶點到串真實的 Google API,把「API 是什麼」走了一整趟。帶走這四個重點:
一個 App 下單時固定呼叫 POST /orders,並從回傳的 JSON 讀取 orderId 和 status。後端後來整套重寫,但這些都沒有改。App 最可能需要怎麼調整?
想想 App 真正依賴的是後端裡面的程式,還是 API 對外提供的呼叫方式與資料格式。