?lang=az|en|ru · Personal: POST /api/auth/login → Authorization: Bearer <JWT>/api/healthaçıqSağlamlıq yoxlaması + asılılıqların vəziyyəti: xarici xəritə/marşrut API-sinin dövrə kəsicisi (closed / open / half_open), xətanın növü, keş ölçüsü, mənbələr üzrə xidmət sayı. mode = online | offline-fallback
{ ok, time, mode, dependencies: { routing: { mode, breaker: { state, retryInMs, lastError }, cacheSize, served } } }/api/configaçıqSOS növləri, dillər, qayda həddləri
{ sosTypes, languages, rules }/api/i18n/:langaçıqTərcümə lüğəti (az, en, ru)
{ lang, messages }/api/districtsaçıqRayonlar siyahısı
[ { id, name, lat, lng } ]/api/pointsaçıqAktiv toplanış məntəqələri və doluluq
[ { id, name, type, capacity, occupied, occupancyPct } ]/api/roadsaçıqYol şəbəkəsi (bağlı yollar daxil)
[ { id, from, to, closed, congestion } ]/api/evacuationaçıqƏn yaxın təhlükəsiz məntəqələr + tövsiyə olunan təxliyyə marşrutu. Məntəqə ≥90% dolu, yol bağlı və ya dolma sürəti səbəbindən çatanda dolacaqsa alternativ təklif olunur.
lat | number |
lng | number |
district | string (lat/lng əvəzinə) |
accessible | 1 = yalnız əlçatan (panduslu/maneəsiz) məntəqə və marşrut. Prioritet rollu imzalı cihaz üçün avtomatik |
{ origin, recommendedPointId, rerouted:{reasons[]}, noSafePoint, routing:{ mode: online | offline-fallback, degraded, sources: [external | cache | matrix | local], reason, cacheAgeSec }, accessible, noAccessibleRoute, needsTransport, points[ {status, projectedPct, fillingFast, accessible, access[], route:{geometry, distanceM, etaMin, source}} ] }/api/sessionaçıqİmzalı cihaz kimliyi alır (IP üzrə sürət limiti var)
deviceId | string (ixtiyari, əvvəlki kimliyi saxlamaq üçün) |
{ deviceId, token }/api/sosixtiyari X-Device-TokenSOS göndərir. X-Device-Token olmadan da qəbul olunur (təsdiqsiz sayılır). Sürət limiti: imzalı cihaz üçün cihaz üzrə, imzasız sorğu üçün IP üzrə + ümumi büdcə (429 + Retry-After). Dublikat filtri: eyni göndərənin eyni növ SOS-u 60 san. ərzində yeni siqnal yaratmır (200, duplicate: true, repeats). Axın (flood) zamanı imzasız SOS qəbul olunur, amma karantinə düşür.
citizenId | string (imzalı token varsa nəzərə alınmır) |
type | FIRE | COLLAPSE | FLOOD | MEDICAL |
lat | number |
lng | number |
accuracy | number (metr, ixtiyari) |
note | string ≤280 |
needs | string[] (ixtiyari, yalnız imzalı cihaz: wheelchair | reduced_mobility | medical_transport. Pis dəyərlər səssiz atılır) |
201 yeni | 200 dublikat: { id, duplicate, repeats, status, createdAt, districtId, verified, priority (1 = Kritik Prioritet), needs[] }/api/broadcastsaçıqDispetçerin göndərdiyi aktiv bildirişlər (yalnız vətəndaşın yerinə aid olanlar). Server vətəndaşın yerini saxlamır, tətbiq öz koordinatı ilə sorğu edir. Əlçatan istifadəçi üçün pandussuz məntəqə əlçatanla əvəzlənir
lat | number |
lng | number |
accessible | 1 = əlçatan məntəqə əvəzləməsi (prioritet rol üçün avtomatik) |
{ broadcasts: [ { id, type, severity, text, point, substituted, expiresAt } ] }/api/broadcasts/:id/ackaçıqVətəndaş bildirişi oxuduğunu təsdiqləyir (dispetçerdə "oxudu" sayğacı)
{ id, acks }/api/sms/inboundaçıqSMS gateway webhook-u (internetsiz SOS). X-Gateway-Key tələb olunur. Komandalar: SOS [növ] [ehtiyac] <rayon | lat,lng>, TEHLUKESIZEM, YER <rayon>. Cavab mətni qayıdır
from | string (nömrə, saxlanılmır, yalnız duzlu hash) |
text | string ≤320 |
{ intent, reply, sosId?, priority? }/api/profileixtiyari X-Device-TokenCihazın rolü: citizen | priority (hərəkət məhdudiyyətli / xüsusi qayğı). X-Device-Token tələb olunur
{ role, needs[], updatedAt }/api/profileixtiyari X-Device-TokenPrioritet SOS rolunu verir/ləğv edir. Rol imzalı cihaza bağlıdır; priority üçün ən azı bir ehtiyac lazımdır. Bundan sonra cihazın hər SOS-u Kritik Prioritet #1 alır
role | citizen | priority |
needs | string[]: wheelchair | reduced_mobility | medical_transport |
{ role, needs[], updatedAt }/api/sos/:idaçıqSOS-un gedişi: stage 0 ləğv, 2 briqada təyin olunur, 3 yardım yoldadır (+ETA)
{ id, status, stage, brigade: { name, kind }, etaSec, etaMin, cancelMsLeft }/api/sos/:id/cancelaçıqÖz SOS-unu 60 san. ərzində ləğv edir ("səhv göndərdim")
citizenId | string (SOS sahibi) |
{ id, status }/api/safeaçıq"Təhlükəsizəm": açıq SOS-ları bağlayır
citizenId | string |
lat | number? |
lng | number? |
{ citizenId, resolvedSos }/api/points/:id/checkinaçıqMəntəqəyə gəliş qeydi (doluluğu artırır)
citizenId | string |
məntəqə/api/auth/loginaçıqPersonal girişi. Uğurlu olarsa HS256 imzalı JWT qaytarır (rol tokenin içindədir). Ünvan və istifadəçi adı üzrə sürət limiti (brute-force qoruması)
username | string |
password | string |
{ token, tokenType: Bearer, expiresInSec, user, role, permissions[] }/api/auth/meBearer JWT (istənilən personal rolu)Cari istifadəçi, rol və icazələr
{ user, role, permissions[], expiresAt }/api/auth/refreshBearer JWT (istənilən personal rolu)Etibarlı tokeni yenisi ilə əvəz edir (növbə ərzində yenidən giriş lazım olmasın)
{ token, expiresInSec, … }/api/auth/logoutBearer JWT (istənilən personal rolu)Çıxış: token dərhal ləğv olunur (deny-list)
{ ok, revoked }/api/auth/stream-ticketBearer (dispetçer/müşahidəçi/admin)Canlı axın (SSE) üçün 30 saniyəlik birdəfəlik bilet. EventSource başlıq göndərə bilmir, JWT isə URL-ə yazılmır
{ ticket, expiresInSec }/api/dashboardBearer (dispetçer/müşahidəçi/admin)Canlı panel snapshot-ı: SOS, məntəqələr, briqadalar, həyəcanlar (plan, typeCounts, undoMsLeft), karantin, hücum nəticəsi
snapshot/api/streamBearer (dispetçer/müşahidəçi/admin)Server-Sent Events: hər dəyişiklikdə "snapshot" hadisəsi. ?ticket= (birdəfəlik bilet) və ya Authorization başlığı
text/event-stream/api/dashboard/historyBearer (dispetçer/müşahidəçi/admin)Zaman maşını: son N dəqiqənin kompakt kadrları
minutes | number ≤240 (default 120) |
{ frames[], t0, t1, everyMs }/api/decisionsBearer (dispetçer/müşahidəçi/admin)Qərar jurnalı: kim, nə vaxt, hansı qərarı verdi (təsdiq, geri qaytarma, buraxma, yol, briqada, bildiriş) + sistem həyəcan hadisələri. IP/token/kimlik yoxdur
limit | number ≤200 (default 30) |
{ decisions: [ { id, t, actor, action, target, details } ] }/api/broadcastsbroadcast:sendKütləvi bildiriş: növ evacuate (məntəqəyə köçün) | shelter | avoid_area | all_clear (əhatə etdiyi xəbərdarlıqları ləğv edir) | custom. Hədəf: bütün şəhər, rayonlar və ya radius
type | evacuate | shelter | avoid_area | all_clear | custom |
severity | info | warning | critical (yalnız custom) |
target | { kind: all } | { kind: districts, districts: [id] } | { kind: radius, lat, lng, radiusM } |
pointId | string (evacuate üçün) |
text | { az, en, ru } ≤280 (custom üçün məcburi) |
expiresInMin | number 1..720 (default 30) |
{ id, type, severity, target, reach, acks, status }/api/broadcasts/:id/cancelbroadcast:sendAktiv bildirişi geri çəkir
bildiriş/api/rulesBearer (dispetçer/müşahidəçi/admin)Cari qayda həddləri
rules/api/alerts/:id/approveBearer (dispetçer/admin)Bir kliklə: SOS növünə uyğun ən yaxın azad briqadanı göndər (yanğın → yanğınsöndürən, tibbi → təcili tibbi, dağıntı/sel → xilasetmə) + ehtiyat məntəqəni aç (amber xəbərdarlıqda yalnız məntəqə). Dispetçer istənilən AZAD briqadanı brigadeId ilə seçib avtomatik seçimi üstələyə bilər. İdempotentdir.
brigadeId | string (ixtiyari; azad olmalıdır) |
alert (result: { brigadeId, etaMin, manual, match })/api/alerts/:id/undoBearer (dispetçer/admin)Təsdiqi 10 saniyə ərzində geri qaytarır
alert/api/sos/:id/dispatchBearer (dispetçer/admin)Tək SOS-a briqada göndər (4 nəfərlik həyəcan gözləmədən). Briqada SOS növünə görə avtomatik seçilir, dispetçer brigadeId ilə üstələyə bilər. Vətəndaşın telefonunda addımlar dərhal yenilənir. 10 san. ərzində geri qaytarıla bilər
brigadeId | string (ixtiyari; azad olmalıdır) |
alert (type SOS_SINGLE, result: { brigadeId, etaMin, manual, match })/api/sos/:id/releaseBearer (dispetçer/admin)Karantindəki SOS-u "doğrudur" kimi buraxır
sos/api/roads/:id/closeBearer (dispetçer/admin)Yolu bağlayır
{ id, closed }/api/roads/:id/openBearer (dispetçer/admin)Yolu açır
{ id, closed }/api/roads/:id/accessibilityBearer (dispetçer/admin)Yol seqmentinin maneəsiz (pilləsiz/pandus) olub-olmadığı: əlçatan marşrut buna görə hesablanır
stepFree | boolean |
{ id, stepFree }/api/roads/:id/congestionBearer (dispetçer/admin)Yol tıxacı əmsalı
factor | number ≥1 |
yol/api/brigades/:id/statusBearer (dispetçer/admin)Briqada statusu
status | available | dispatched | on_scene | offline |
briqada/api/sim/occupancyBearer (yalnız admin)Məntəqənin doluluğunu təyin edir
pointId | string |
occupied | number |
məntəqə/api/sim/chaosBearer (yalnız admin)Xarici xəritə API-sinin nasazlığını simulyasiya edir: mode = ok | http503 | slow (cavab 5 san.-dən gec) | error (şəbəkə xətası). ok seçiləndə dövrə kəsici dərhal sınaq sorğusu göndərir. Köhnə externalDown / externalLatencyMs də işləyir
mode | ok | http503 | slow | error |
externalDown | boolean (köhnə) |
externalLatencyMs | number (köhnə) |
chaos/api/sim/rulesBearer (yalnız admin)Qayda həddlərini işləyərkən dəyişir (yoxlanılır). "Təhlükəsizlik rejimi": requireVerified
minDistinctReporters | number |
overcrowdPct | number |
requireVerified | boolean |
… | bax /api/config |
rules/api/sim/scenariosBearer (yalnız admin)Demo ssenari adları
[ name ]/api/sim/smsBearer (yalnız admin)SMS simulyatoru: gateway açarı olmadan eyni emal xəttini işlədir
from | string |
text | string |
{ intent, reply }/api/sim/scenarioBearer (yalnız admin)Ssenarini real boru kəmərində işlədir
name | cluster | fake_flood | mass_event | filling | overcrowd | api_outage | road_block | reset |
{ name, … }/api/sim/resetBearer (yalnız admin)Bütün vəziyyəti sıfırlayır
{ ok }