API struktūra
Backend teikia REST API per FastAPI. Interaktyvi dokumentacija: gpais.smala.lt/api/docs
Endpointai
Bendri
| Metodas | Kelias | Paskirtis |
|---|---|---|
| GET | /api/health | Health check |
| POST | /api/auth/login | Prisijungimas |
| GET | /api/auth/me | Dabartinis vartotojas |
| GET | /api/classifiers | Klasifikatoriai (su filtravimu pagal tipą) |
GII modulis (/api/gii/)
| Metodas | Kelias | Paskirtis |
|---|---|---|
| GET | /api/gii/registrations | Registracijų sąrašas |
| GET | /api/gii/registrations/{id} | Registracijos detalės |
| GET | /api/gii/requests | Prašymų sąrašas |
| GET | /api/gii/requests/{id} | Prašymo detalės |
| POST | /api/gii/requests | Naujas registracijos prašymas |
| PUT | /api/gii/requests/{id} | Prašymo atnaujinimas |
| POST | /api/gii/requests/{id}/submit | Prašymo pateikimas |
| GET | /api/gii/terminations | Išregistravimo prašymai |
| POST | /api/gii/terminations | Naujas išregistravimo prašymas |
| GET | /api/gii/public/registrations | Viešas registras |
| GET | /api/gii/mock/jar/{code} | JAR integracija (mock) |
GIIORG modulis (/api/giiorg/)
| Metodas | Kelias | Paskirtis |
|---|---|---|
| GET | /api/giiorg/licenses | Licencijų sąrašas |
| GET | /api/giiorg/licenses/{id} | Licencijos detalės |
| GET | /api/giiorg/mandate-holders | Mandatų turėtojai |
| GET | /api/giiorg/mandate-holders/{id} | Turėtojo detalės |
| POST | /api/giiorg/mandate-holders/{id}/mandates | Naujas mandatas |
| PUT | /api/giiorg/mandates/{id} | Mandato atnaujinimas |
| DELETE | /api/giiorg/mandates/{id} | Mandato šalinimas |
| GET | /api/giiorg/vup/packages | VUP paketai |
| GET | /api/giiorg/vup/journals | VUP žurnalai |
| GET | /api/giiorg/activity-documents | Veiklos dokumentai |
| GET | /api/giiorg/activity-documents/{id} | Dokumento detalės |
Autentifikacija
JWT token autentifikacija. Token gaunamas per /api/auth/login ir siunčiamas Authorization: Bearer <token> header'yje.
Klasifikatoriai
Klasifikatoriai yra bendri reference data, naudojami visuose moduliuose:
| Tipas | Paskirtis |
|---|---|
| COUNTRY | Šalys |
| MUNICIPALITY | Savivaldybės |
| ORG_TYPE | Organizacijų tipai |
| OIL_TYPE | Alyvų tipai |
| VEHICLE_CLASS | Transporto priemonių klasės |
| EEE_CATEGORY | EEĮ kategorijos |
| BATTERY_TYPE | Baterijų tipai |
| BATTERY_CHEMISTRY | Baterijų cheminė sudėtis |
| TAXABLE_PRODUCT | Apmokestinamieji produktai |
| PACKAGING_MATERIAL | Pakuočių medžiagos |
| ATTACHMENT_TYPE | Priedų tipai |
| DEREGISTRATION_REASON | Išregistravimo priežastys |
| LICENSE_TYPE | Licencijų tipai |
| PARTICIPATION_FORM | Dalyvavimo formos |
| BEVERAGE_TYPE | Gėrimų tipai |
| PACKAGE_CATEGORY | Pakuočių kategorijos |
| PACKAGE_TYPE | Pakuočių tipai |