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

用量与定价

每次调用计为一次查询，与在门户中查询相同。你所在机构的管理员可以在门户中按月查看查询次数。定价与每个合作伙伴单独商定；试点免费。

申请访问权限