API partner EbikeMate
Verifica una e-bike nel registro EbikeMate dal tuo sistema. Per partner verificati: assicuratori, flotte, comuni e rivenditori.
Ottenere una chiave
Your organisation admin creates keys a the Portale partner (Partner portal → API & usage). A key is shown once — store it like a password. Send it on every call:
Authorization: Bearer ebm_live_…
Fino a 120 chiamate al minuto per chiave. Revoca una chiave in qualsiasi momento; le chiamate con quella chiave si fermano subito.
Verifica una bici
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.
Assicuratori: verifica una richiesta di risarcimento
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 a your organisation’s log.
Errori
- 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
Utilizzo e prezzi
Ogni chiamata conta come una verifica, come una verifica nel portale. L’amministratore della tua organizzazione può vedere le verifiche per mese nel portale. I prezzi sono concordati con ciascun partner; le fasi pilota sono gratuite.