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

الاستخدام والتسعير

كل عملية استدعاء تُحتسب عملية تحقق واحدة، مثل التحقق عبر البوابة. يمكن لمسؤول جهتك رؤية عمليات التحقق شهريًا في البوابة. يُتفق على التسعير مع كل شريك؛ والفترات التجريبية مجانية.

اطلب الوصول

API الشركاء من EbikeMate

الحصول على مفتاح

تحقق من دراجة

شركات التأمين: التحقق من مطالبة

الأخطاء

الاستخدام والتسعير

دراجتك

أضف دراجتك

أين أنت؟