EbikeMate 合作夥伴 API
從你自己的系統以 EbikeMate 登記冊查核電動單車。適用於已驗證的保險公司、車隊、市議會及商戶合作夥伴。
取得金鑰
Your organisation admin creates keys（the） 合作夥伴平台 (Partner portal → API & usage). A key is shown once — store it like a password. Send it on every call:
Authorization: Bearer ebm_live_…
每個金鑰每分鐘最多 120 次呼叫。可隨時撤銷金鑰；撤銷後以該金鑰的呼叫會即時停止。
查核單車
GET https://www.ebikemate.com.au/api/v1/bikes/check?serial=WTU123456C
Pass serial (the frame serial) or emid (the EbikeMate ID). The answer:
{
"found": true,
"emid": "AU-7KQ2-M9XD",
"bike": { "make": "Giant", "model": "Explore E+ 3", "year": 2024, "colour": "Grey", "serial": "WTU•••456C" },
"status": "active", // active · stolen · lost
"stolen": null, // when stolen: { "reportedAt", "area", "policeReportOnFile" }
"verification": "retailer", // registered · evidence · retailer · transfer · high
"verificationLabel": "Retailer verified",
"registered": "2024-03-02",
"currentOwnerSince": "2024-03-02T00:00:00.000Z",
"previousOwners": 0,
"serviceRecords": 2,
"battery": { "healthPct": 94, "checkedOn": "2026-08-14", "checkedByShop": true },
"requestId": "…"
}
A bike that isn’t registered returns { "found": false }. Owner names and contact details are never returned.
保險公司：核實索償
POST https://www.ebikemate.com.au/api/v1/insurer/verify
Content-Type: application/json
{ "serial": "WTU123456C", "claimReference": "CLM-20419", "claimantEmail": "name@example.com", "claimantName": "Jo Citizen" }
Returns everything above, plus claimantMatchesOwner (true, false, or null if you sent no claimant details) and proofOfPurchaseOnFile. The claim reference is kept（your organisation’s log.）
錯誤
- 401 — missing or revoked key
- 403 — your organisation’s kind can’t use that check
- 422 — check the fields named in
fields - 429 — slow down
用量及收費
每次呼叫計算為一次查核，與在平台查核相同。你機構的管理員可在平台按月查看查核次數。收費與各合作夥伴個別協定；試行計劃免費。