API đối tác EbikeMate

Kiểm tra xe đạp điện với sổ đăng ký EbikeMate từ hệ thống của bạn. Dành cho đối tác đã xác minh là công ty bảo hiểm, đội xe, hội đồng địa phương và đại lý.

Nhận khóa

Your organisation admin creates keys tại the Cổng đối tác (Partner portal → API & usage). A key is shown once — store it like a password. Send it on every call:

Authorization: Bearer ebm_live_…

Tối đa 120 lượt gọi mỗi phút cho mỗi khóa. Thu hồi khóa bất cứ lúc nào; các lượt gọi bằng khóa đó sẽ dừng ngay.

Kiểm tra xe

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.

Công ty bảo hiểm: xác minh yêu cầu bồi thường

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 tại your organisation’s log.

Lỗi

• 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

Mức sử dụng và giá

Mỗi lượt gọi tính là một lượt kiểm tra, giống như kiểm tra trên cổng. Quản trị viên tổ chức có thể xem số lượt kiểm tra theo tháng trên cổng. Giá được thỏa thuận với từng đối tác; giai đoạn thử nghiệm miễn phí.

Yêu cầu quyền truy cập