EbikeMate partner API
I-check ang e-bike sa rehistro ng EbikeMate mula sa sarili mong system. Para sa mga beripikadong partner na insurer, fleet, council at dealer.
Pagkuha ng key
Your organisation admin creates keys sa the Partner portal (Partner portal → API & usage). A key is shown once — store it like a password. Send it on every call:
Authorization: Bearer ebm_live_…
Hanggang 120 call bawat minuto bawat key. Bawiin ang key anumang oras; agad na hihinto ang mga call gamit ito.
I-check ang bike
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.
Mga insurer: beripikahin ang claim
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 sa your organisation’s log.
Mga error
- 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
Paggamit at presyo
Binibilang ang bawat call bilang isang check, katulad ng check sa portal. Makikita ng admin ng organisasyon mo ang mga check bawat buwan sa portal. Napagkakasunduan ang presyo sa bawat partner; libre ang mga pilot.