Autopass 停車場服務文件
  1. 車牌辨識進出 API
Autopass 停車場服務文件
  • 🚘 車牌辨識進出
    • 🚗 概述
    • 🧠 核心概念
    • 🔐 API 連線配置
    • ⚙️ Rate Limit(速率限制)說明
    • 🧩 使用案例
      • 首選交易流程
      • 管理停車紀錄
  • 🔥 使用 AI 輔助進行整合
    • 純文字文件
    • MCP protocol
  • </> API Reference
    • 車牌辨識進出 API
      • 查詢車輛停車紀錄列表
        GET
      • 查詢車輛停車紀錄
        GET
      • 車輛進場
        POST
      • 取消停車紀錄
        POST
      • 車輛離場
        POST
      • 修改車進場資訊
        PUT
      • 修改車輛離場資訊
        PUT
      • 請款
        POST
      • 直接請款
        POST
  1. 車牌辨識進出 API

直接請款

Testing Env
https://maas-alpha-maas-api.pklotcorp.com
Testing Env
https://maas-alpha-maas-api.pklotcorp.com
POST
https://maas-alpha-maas-api.pklotcorp.com
/parking-lots/v1/alpr/transactions/direct-charge
建立一筆狀態為 已離場(ENDED)的停車紀錄。
若該車輛為會員,系統會自動向該會員進行請款。

去除重複(Deduplicate)#

當出口閘門配置多台攝影機同時進行車牌辨識並發出請款請求時,
Autopass 會自動執行「去除重複(Deduplicate)」處理,以避免重複扣款。

運作原理#

1.
當 API 接收到的請求同時符合以下條件時,會視為同一筆停車紀錄:
車牌號碼相同
車種相同
停車場相同
請款時間(chargeDateTime)與此次請求的請款時間(chargeDateTime)相近(1 分鐘內)
2.
若該筆停車紀錄 已成功付款,系統會回傳「扣款成功」,不再重複請款。
3.
若該筆停車紀錄 尚未付款成功,系統會再次嘗試扣款,並返回扣款結果。

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200OK
application/json
Body

🟠401未認證
🟠403權限不足
🟠422請款失敗
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://maas-alpha-maas-api.pklotcorp.com/parking-lots/v1/alpr/transactions/direct-charge' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "plateNumber": "ABC-2025",
    "vehicleClass": "CAR",
    "amount": 55,
    "startDateTime": "2025-10-28T12:11:33.427+08:00",
    "startImageFile": null,
    "startImageUrl": null,
    "chargeDateTime": "2025-10-28T20:11:33.000+08:00",
    "endImageUrl": null
}'
Response Response Example
200 - Success
{
    "data": {
        "parkingSessionId": "3a628a23-d32f-4154-a5f1-2094c26d630e",
        "plateNumber": "NFH-2111",
        "startDateTime": "2025-10-25T12:00:00.427+08:00",
        "chargeDateTime": "2025-10-26T20:00:33.000+08:00",
        "amount": 550
    }
}
Modified at 2025-10-29 07:34:22
Previous
請款
Built with