API Ειδοποιήσεων

Maintained by: Aether365 Team Audience: Developers Scope: Notification settings API endpoints

Διαχείριση ρυθμίσεων ειδοποιήσεων email και Teams για το πιστοποιημένο tenant.

Ανάκτηση Ρυθμίσεων Ειδοποιήσεων

GET /tenants/me/notifications

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

Πεδία Απάντησης

Πεδίο	Τύπος	Περιγραφή
emailOnComplete	boolean	Αποστολή email όταν μια σάρωση ολοκληρωθεί επιτυχώς
emailOnFail	boolean	Αποστολή email όταν μια σάρωση αποτύχει
teamsWebhookUrl	string ή null	URL incoming webhook Microsoft Teams
teamsOnComplete	boolean	Δημοσίευση στο Teams όταν μια σάρωση ολοκληρωθεί
teamsOnFail	boolean	Δημοσίευση στο Teams όταν μια σάρωση αποτύχει

---

Ενημέρωση Ρυθμίσεων Ειδοποιήσεων

Ενημερώνει τις ρυθμίσεις ειδοποιήσεων. Αλλάζουν μόνο τα πεδία που συμπεριλαμβάνετε.

PATCH /tenants/me/notifications

Σώμα Αιτήματος

Ολα τα πεδία είναι προαιρετικά. Συμπεριλάβετε μόνο τα πεδία που θέλετε να αλλάξετε.

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

Παράδειγμα: Ενεργοποίηση ειδοποιήσεων Teams

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
  }'

Παράδειγμα: Απενεργοποίηση όλων των ειδοποιήσεων email

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

Παράδειγμα Απάντησης

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

Σφάλματα

Κωδικός	HTTP	Περιγραφή
AUTH_INSUFFICIENT_SCOPE	403	Ανεπαρκή δικαιώματα για αυτή την ενέργεια
VALIDATION_ERROR	400	Μη έγκυρη μορφή URL webhook