Open API

Окуу үчүн гана REST API. 1С, BI-дашборд, мектептин өз сайтын же өз скриптиңизди туташтырыңыз — ал мектебиңиздин маалыматын корголгон ачкыч боюнча окуйт. API аркылуу эч нерсе жазууга болбойт. Эгер иштеп чыгаруучу кодунда ката кетирсе, Drivli'деги окуучуларды же төлөмдөрдү бул бузбайт.

«Профи» жана «VIP» тарифтеринде жеткиликтүү. Free жана «Стандарт»та ачкыч берилбейт.

Авторизация

Ачкычты директор кабинетинен алыңыз: Реквизиттер → 🔑 API → Ачкыч түзүү. Аны ар бир суроонун аталышында өткөрүңүз:

Authorization: Bearer drivli_pk_<32 hex>

Ачкыч так бир жолу гана көрсөтүлөт — түзүүдө көчүрүп алыңыз.
Бир ачкыч = бир мектеп, бөтөн маалымат физикалык жактан жеткиликсиз.
Бир мектепке 10 активдүү ачкычка чейин. Колдонулбагандарды кайтарып алыңыз.
Базада ачкычтын хэши гана сакталат — базанын бузулушу иштеген ачкычтарды бербейт.

Лимиттер

Профи: мүнөтүнө 60 суроо.
VIP: мүнөтүнө 600 суроо.
Ашып кетүү → Retry-After: 60 аталышы менен 429 Too Many Requests жообу.

Тез баштоо

Алгачкы 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» — ачкычты бир мүнөттө түзүңүз.

Акысыз сынап көрүү Тарифтер