API Ridefax

Перевірка транспорту з вашої облікової системи. Доступний на тарифах «Мережа» і вище.

Автентифікація

Токен випускається в кабінеті організації й передається в заголовку:

Authorization: Bearer {ваш_токен}

Токен належить організації, а не співробітнику — зміна персоналу його не ламає. Доступ вимикається, якщо організацію призупинено або оплачений період вийшов (у відповідь піде 402).

Перевірити транспорт

POST https://ridefax.com.ua/api/v1/lookup
Content-Type: application/json

{"identifier": "XM2023ABC"}

Приймається будь-який ідентифікатор: серійний номер, рама, IMEI або номер батареї.

{
  "data": {
    "status": "stolen",
    "verdict": "alarm",
    "headline": "Транспорт у розшуку",
    "explanation": "Власник заявив про крадіжку цього транспорту.",
    "advice": "Не купуйте і не приймайте його…",
    "details": ["Зареєстровано: 12.03.2025", "Заявлено про крадіжку: 09.09.2026", "Місто: Київ"],
    "vehicle": {"type": "scooter", "brand": "Xiaomi", "model": "Pro 2",
                "registered_at": "2025-03-12", "transfers": 1},
    "receipt_number": "260911-K4M2XP",
    "receipt_url": "https://ridefax.com.ua/receipt/260911-K4M2XP"
  }
}

Значення status

• not_found — номера немає в реєстрі. Це не означає «чистий»
• clean — зареєстрований, у розшуку не значиться
• warning — зареєстрований менш ніж тиждень тому
• disputed — той самий номер зареєстрували двоє, триває спір
• stolen — заявлений як вкрадений

Пакетна перевірка

POST https://ridefax.com.ua/api/v1/lookup/batch

{"identifiers": ["XM2023ABC", "BAT-778-99"]}

До 100 ідентифікаторів за раз — зручно для інвентаризації складу.

Отримати чек повторно

GET https://ridefax.com.ua/api/v1/lookup/260911-K4M2XP

Залишок за тарифом

GET https://ridefax.com.ua/api/v1/usage

Ліміти

Кожна відповідь містить X-RateLimit-Limit і X-RateLimit-Remaining. При перевищенні — 429 із заголовком Retry-After. Ліміт запитів налаштовується на кожному токені окремо, ліміт перевірок — спільний на всю організацію за тарифом.

Чого API не віддає

Жодних даних власника: ні імені, ні телефону, ні Telegram, ні ідентифікаторів. Це не обмеження тарифу, а принцип — інакше реєстр перетворився б на інструмент пошуку людей за їхнім майном.

Чек перевірки

Кожна перевірка через API створює чек із унікальним номером. Сторінка receipt_url відкрита без авторизації — її можна показати клієнту або долучити до матеріалів справи як доказ, що ви перевіряли транспорт у момент прийому.