Open API

Вулама ҫеҫ REST API. 1С, BI-дашборд, хӑвӑн шкул сайтне е хӑвӑн скрипта ҫыхӑнтар — вӑл санӑн шкул даннӑйӗсене хӳтӗленӗ ключпа вулать. API урлӑ нимӗн те ҫырма ҫук. Разработчик кодра йӑнӑшсан та, вӑл Drivli-ра вӗренекенсене е тӳлевсене пӑсаймасть.

«Профи» тата «VIP» тарифсенче пур. Free тата «Стандарт»-ра ключ памаҫҫӗ.

Авторизаци

Ключа директор кабинетӗнче ил: Реквизитсем → 🔑 API → Ключ ту. Ӑна кашни ыйтун заголовокӗнче пар:

Authorization: Bearer drivli_pk_<32 hex>

Ключ шӑп пӗрре кӑтартать — туса хунӑ чухне копиле.
Пӗр ключ = пӗр шкул, ют даннӑйсем физикӑллӑ май ҫук.
Пӗр шкула 10 актив ключ таран. Усӑ курманнисене каялла ил.
БД-ра ключӑн хешӗ ҫеҫ упранать — БД компрометацийӗ ӗҫлекен ключсем памасть.

Лимитсем

Профи: минутра 60 ыйту.
VIP: минутра 600 ыйту.
Иртсе кайни → 429 Too Many Requests ответ Retry-After: 60 заголовокпа.

Хӑвӑрт пуҫлав

Малтанхи 10 актив вӗренекен списокӗ:

curl -H "Authorization: Bearer drivli_pk_..." \
  "https://api.drivli.ru/api/public/v1/students?status=learning_practice&limit=10"

Ответ:

{
  "items": [
    {
      "id": "9b8a...",
      "full_name": "Иванов И. И.",
      "phone": "+7 555 ...",
      "email": "ivanov@example.com",
      "category": "B",
      "status": "learning_practice",
      "group_id": "f3c1...",
      "branch_id": null,
      "created_at": "2026-04-12T08:30:00Z"
    }
  ],
  "meta": { "total": 142, "limit": 10, "offset": 0 }
}

Эндпоинтсем

Меслет	Ҫул	Ӑнлантару
GET	/api/public/v1/students	Шкул вӗренекенӗсен списокӗ. Параметрсем: status, category, group_id, limit (≤200), offset
GET	/api/public/v1/students/{id}	Пӗр вӗренекенӗн карточки.
GET	/api/public/v1/instructors	Инструкторсен списокӗ. Параметрсем: is_active, limit, offset
GET	/api/public/v1/vehicles	ОСАГО тата ТО даттисемпе вӗренӳ автомобилӗсен списокӗ. Параметрсем: limit, offset
GET	/api/public/v1/lessons	Тапхӑр хушшинчи занятисен списокӗ. Параметрсем: period_from, period_to, instructor_id, student_id, limit, offset
GET	/api/public/v1/contracts	Вӗренекенсемпе договорсем. Параметрсем: student_id, limit, offset
GET	/api/public/v1/payments	Тапхӑр хушшинчи тӳлевсем. Параметрсем: period_from, period_to, limit, offset
GET	/api/public/v1/leads	Вӗренӳ заявкисем. Параметрсем: status, period_from, period_to, limit, offset
GET	/api/public/v1/reports/finance-summary	Тапхӑр хушшинчи финанс пӗтӗмлетӗвӗ: тупӑш, тӑкак, прибыль. Параметрсем: period_from, period_to

Хӑрушсӑрлӑх

152-ФЗ пиртен вӗренекенсен даннӑйӗсене хӳтӗлеме хушать. Ҫавӑнпа API ҫапла тунӑ:

HTTPS ҫеҫ. HTTP урлӑ пачах ответ памастпӑр.
GET ҫеҫ. API урлӑ мӗн те пулин ҫырма е хуратма ҫук.
БД-ра пирӗн ключӑн хешӗ ҫеҫ выртать. Кам та пулин пирӗн базӑна йӑтса кайсан — унтан ӗҫлекен ключсем кӑлараймасть.
Пӗр ключ = пӗр шкул. Ют даннӑйсене ключ питӗ хытӑ тӑрӑшсан та кураймасть — изоляци SQL-схема шайӗнче.
Кашни ыйту ключ карточкинче палӑрать: юлашки усӑ курнӑ датӑпа счётчик курӑнать. Ключа кам та пулин туртса илсен — ку палӑрать.
Ключа каялла илтӗн — унпа тепӗр ыйту 401 тавӑрать. Репликаци е кэш тӑхтавӗсӗр.

Ответ кочӗсем

200 — ӑнӑҫу.
400 — ыйту параметрӗ тӗрӗс мар.
401 — ключ ҫук, ключ тӗрӗс мар е ключа каялла илнӗ.
402 — шкул «Профи»-ран аяларах тарифра, Open API хупӑ.
404 — ыйтнӑ сущность тупӑнмарӗ.
429 — минутри ыйту лимичӗ иртсе кайнӑ.
503 — rate-limit сервис ҫук (сайра).

Ҫыхӑнма хатӗр-и?

Директор кабинетне уҫ → «Реквизитсем» → «🔑 API» — ключа минутра ту.

Тӳлевсĕр тӗрӗслесе пӑхас Тарифсем