1.註冊 & 登入
- 建立 Shell 開發者帳戶或登入。
- 前往「我的應用程式」，點擊「新增應用程式」，並為您的專案命名。
- 選擇您要測試的 API
2.取得您的憑證
- 前往您的個人檔案下的「我的應用程式」，點擊「檢視應用程式」，並複製您的 API 金鑰和密鑰。
- 使用您偏好的 API 測試工具（例如：Postman、Insomnia、curl）。
3. 測試基本 API
- 位置 API (EV 公共地點、 B2B Mobility 網站）現已開放使用。
- 無需 Shell 帳戶即可測試的操作：
| 情境 | 說明 |
|---|---|
| 驗證 | 透過簡單請求測試 API 金鑰／密鑰，以確認存取權限。 |
| 擷取位置 | 使用分頁功能取得 EV 位置的第一頁或特定頁面的資料。 |
| 篩選與查詢 | 依國家／營運商篩選，或透過位置 ID 擷取資料（包含正向與負向案例）。 |
4. 申請進階存取權限
針對如 Mobility Card Management、SmartPay，或 Mobility 卡近期交易，我們的 API 支援團隊需要於我們的車隊管理系統中建立並自訂 Mobility 客戶帳戶。
若要獲得完整存取權限，必須具備已驗證的客戶關係。
如需申請存取權限，請建立帳戶並 提交支援單
5.轉至生產環境
- 簽署補充協議後，您將收到生產環境的憑證。
- 訂閱更新與維護警示通知
錯誤處理
Shell API 會傳回標準的 HTTP 狀態碼，並為清晰起見，還會傳回自訂錯誤碼。
如需詳細範例與最佳實務，請參閱 錯誤處理與最佳實務。
