Értesítések API

Az autentikált bérlő e-mail és Teams értesítési beállításainak kezelése.

Értesítési beállítások lekérdezése

GET /tenants/me/notifications

Példa kérés

curl https://api.aether365.io/tenants/me/notifications \
  -H "Authorization: Bearer <token>"

Példa válasz

{
  "success": true,
  "data": {
    "emailOnComplete": true,
    "emailOnFail": true,
    "teamsWebhookUrl": "https://outlook.office.com/webhook/...",
    "teamsOnComplete": true,
    "teamsOnFail": true
  }
}

Válasz mezők

Mező	Típus	Leírás
emailOnComplete	boolean	E-mail küldése a vizsgálat sikeres befejezésekor
emailOnFail	boolean	E-mail küldése a vizsgálat sikertelensége esetén
teamsWebhookUrl	string vagy null	Microsoft Teams bejövő webhook URL
teamsOnComplete	boolean	Teams-üzenet küldése a vizsgálat befejezésekor
teamsOnFail	boolean	Teams-üzenet küldése a vizsgálat sikertelensége esetén

---

Értesítési beállítások frissítése

Frissíti az értesítési beállításokat. Csak a megadott mezők módosulnak.

PATCH /tenants/me/notifications

Kéréstörzs

Minden mező opcionális. Csak a módosítani kívánt mezőket adja meg.

{
  "emailOnComplete": true,
  "emailOnFail": true,
  "teamsWebhookUrl": "https://outlook.office.com/webhook/...",
  "teamsOnComplete": true,
  "teamsOnFail": false
}

Példa: Teams értesítések engedélyezése

curl -X PATCH https://api.aether365.io/tenants/me/notifications \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "teamsWebhookUrl": "https://outlook.office.com/webhook/your-webhook-url",
    "teamsOnComplete": true,
    "teamsOnFail": true
  }'

Példa: Összes e-mail értesítés letiltása

curl -X PATCH https://api.aether365.io/tenants/me/notifications \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "emailOnComplete": false,
    "emailOnFail": false
  }'

Példa válasz

{
  "success": true,
  "data": {
    "emailOnComplete": false,
    "emailOnFail": false,
    "teamsWebhookUrl": "https://outlook.office.com/webhook/...",
    "teamsOnComplete": true,
    "teamsOnFail": true
  }
}

Hibák

Kód	HTTP	Leírás
AUTH_INSUFFICIENT_SCOPE	403	Elégtelen jogosultság a művelethez
VALIDATION_ERROR	400	Érvénytelen webhook URL formátum