API Reference
Acest conținut nu este încă disponibil în limba selectată.
Bază admin/UI: https://gnotify.gstack.esempla.systems. Port local 8090.
Legendă acces: mtls = certificat client PFX (/api/v1) · admin = ROLE_ADMIN · operator = operator scopat pe sistem · me = cetățean autentificat (self-service) · auth = orice autentificat.
Erori: /api/v1/** = {"message": …} (stil Laravel); restul = JHipster problem+json.
API mașină /api/v1/** (mTLS)
Section titled “API mașină /api/v1/** (mTLS)”| Metodă | Cale | Descriere |
|---|---|---|
| POST | /api/v1/notify/{id} | trimite o notificare ({id} = trackingId); creează Notificare + N×Livrare |
| GET | /api/v1/notify/{id} | status agregat + livrări după trackingId |
| POST | /api/v1/notify-by-id/{id} | trimite după IDNP/IDNO (Registrul Destinatarilor) |
| GET | /api/v1/template | listează șabloanele sistemului |
| POST | /api/v1/template | creează/încarcă un șablon |
| PUT | /api/v1/template/{id} | actualizează un șablon |
Administrare
Section titled “Administrare”| Metodă | Cale | Acces | Descriere |
|---|---|---|---|
| POST | /api/admin/notify | admin | consola de trimitere (suportă forwardMnotify) |
| GET | /api/admin/mail-senders | admin | registrul de expeditori SES |
| POST | /api/admin/notify-by-id | admin | trimite după IDNP/IDNO sau grup |
| POST/PUT/DELETE | /api/admin/provision/{user,link,link/{id}} | admin | provizionare destinatari + legare user self-service |
| GET | /api/admin/provision/users | admin | utilizatorii provizionați |
| GET | /api/admin/rabbit/queues | admin | adâncimile cozilor |
| GET | /api/admin/rabbit/queues/{queue}/messages | admin | previzualizează mesaje |
| POST | /api/admin/rabbit/queues/{queue}/replay | admin | replay din DLQ |
| POST | /api/admin/rabbit/queues/{queue}/purge | admin | golește o coadă |
| POST/GET/DELETE | /api/admin/users[...] | admin | gestionare jhi_user |
Operator (scopat pe sistem)
Section titled “Operator (scopat pe sistem)”| Metodă | Cale | Descriere |
|---|---|---|
| GET | /api/operator/context | contextul operatorului (sistemul său) |
| GET/POST/PUT/DELETE | /api/operator/groups[/{id}] | grupurile sistemului |
| GET | /api/operator/templates | șabloanele sistemului |
| POST | /api/operator/notify-by-id | trimite după ID/grup, scopat |
Portal cetățean (self-service me)
Section titled “Portal cetățean (self-service me)”| Metodă | Cale | Descriere |
|---|---|---|
| GET | /api/registry/me | contul meu de destinatar |
| GET/POST/PUT/DELETE | /api/registry/me/contacts[/{id}] | contactele mele |
| GET/POST/PUT/DELETE | /api/registry/me/preferences[/{id}] | preferințele mele |
| GET | /api/registry/push-public-key | cheia VAPID publică |
| GET | /api/registry/me/push-subscriptions | abonările mele push |
| POST/DELETE | /api/registry/me/push-subscription | abonează/dezabonează Web Push |
CRUD de bază (JHipster — admin)
Section titled “CRUD de bază (JHipster — admin)”Fiecare: GET (listă+filtre+paginare), GET /count, GET /{id}, POST, PUT /{id}, PATCH /{id}, DELETE /{id}.
/api/sistems · /api/templates · /api/notificares · /api/livrares · /api/eveniment-notificares (append-only) · /api/providers (ROLE_ADMIN)
CRUD Registrul Destinatarilor (când gnotify.recipients.enabled)
Section titled “CRUD Registrul Destinatarilor (când gnotify.recipients.enabled)”/api/destinatars · /api/canal-contacts · /api/preferinta-notificares · /api/grups · /api/push-subscriptions
Cont & autentificare
Section titled “Cont & autentificare”| Metodă | Cale | Acces |
|---|---|---|
| POST | /api/authenticate | pub → JWT |
| POST | /api/register · GET /api/activate | pub |
| GET/POST | /api/account | auth |
| GET | /api/users | auth (listă publică utilizatori) |
Health
Section titled “Health”GET /management/health · /management/info · /management/prometheus.