線上試打

直接在文件站送出請求：端點與參數即時取自 APIM，金鑰可從開發者平台交棒過來，不必手動複製。

寫程式之前先送一次請求，是最快確認「參數對不對、金鑰有沒有開通」的方式。文件站的試打面板就是為了這件事：端點、參數與必填與否都即時取自 APIM，跟 gateway 實際受理的內容一致。

怎麼打開

  1. 到 Places & Routes，從左側展開任一服務，點一個端點。
  2. 端點頁上按「測試 API」。
  3. 填參數、送出，回應（狀態碼、標頭、內容）會直接顯示在下方。

金鑰怎麼帶

面板上方的 Authorization 區塊填訂閱金鑰（Ocp-Apim-Subscription-Key），與參數區的 Key 是同一把（見基本介紹）。

若是在開發者平台的個人資料頁，每一組訂閱金鑰旁邊都有「帶去試打」，按下去會直接跳到文件站並把那把金鑰帶進來，在面板的金鑰選單裡就選得到。

送出去之前要知道的事

  • 試打是真的呼叫：會實際打到 gateway，計入訂閱方案的用量與流量限制。
  • 回應原樣顯示：不做任何加工，看到什麼就是你的程式會收到什麼。
  • 失敗先看狀態碼：401 是訂閱金鑰沒帶或無效、403 多半是這支 API 不在你的方案裡，對照錯誤處理那一節。
  • 金鑰不會留在網址上：帶過來的金鑰存在瀏覽器的 sessionStorage，關掉分頁就沒了，也不會寫進網址或分享連結。