API συνεργατών EbikeMate
Ελέγξτε ένα ηλεκτρικό ποδήλατο στο μητρώο 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
Χρήση και τιμολόγηση
Κάθε κλήση μετράει ως ένας έλεγχος, όπως ένας έλεγχος στην πύλη. Ο διαχειριστής του οργανισμού σας βλέπει τους ελέγχους ανά μήνα στην πύλη. Η τιμολόγηση συμφωνείται με κάθε συνεργάτη· οι πιλοτικές περίοδοι είναι δωρεάν.