معالجات الإشعارات
GET https://tistos.com/api/notification-handlers/
curl --request GET \
--url 'https://tistos.com/api/notification-handlers/' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://tistos.com/api/notification-handlers/' \
--header 'Authorization: Bearer {api_key}' \
| المعلمات | تفاصيل | وصف |
|---|---|---|
| search | اختياري سلسلة | سلسلة البحث |
| search_by | اختياري سلسلة | بأي حقل تبحث؟ القيم المسموح بها هي: name |
| is_enabled | اختياري قيمة منطقية | |
| type | اختياري سلسلة | بأي حقل تبحث؟ القيم المسموح بها هي: email, webhook, slack, discord, telegram, microsoft_teams, x, google_chat |
| datetime_field | اختياري سلسلة | القيم المسموح بها: datetime, last_datetime |
| datetime_start | اختياري سلسلة | قم بتصفية النتائج بدءًا من هذا التاريخ والوقت. التنسيق Y-m-d H:i:s. |
| datetime_end | اختياري سلسلة | قم بتصفية النتائج حتى هذا التاريخ والوقت. التنسيق Y-m-d H:i:s. |
| order_by | اختياري سلسلة | ما هو الحقل الذي يتم ترتيب النتائج حسبه. القيم المسموح بها هي: notification_handler_id, datetime, last_datetime, name |
| order_type | اختياري سلسلة | ترتيب النتائج. القيم المسموح بها هي: ASC للترتيب التصاعدي، و DESC للترتيب التنازلي |
| search | اختياري سلسلة | سلسلة البحث |
| search_by | اختياري سلسلة | بأي حقل تبحث؟ القيم المسموح بها هي: name |
| is_enabled | اختياري قيمة منطقية | |
| type | اختياري سلسلة | بأي حقل تبحث؟ القيم المسموح بها هي: email, webhook, slack, discord, telegram, microsoft_teams, x, google_chat |
| datetime_field | اختياري سلسلة | القيم المسموح بها: datetime, last_datetime |
| datetime_start | اختياري سلسلة | قم بتصفية النتائج بدءًا من هذا التاريخ والوقت. التنسيق Y-m-d H:i:s. |
| datetime_end | اختياري سلسلة | قم بتصفية النتائج حتى هذا التاريخ والوقت. التنسيق Y-m-d H:i:s. |
| order_by | اختياري سلسلة | ما هو الحقل الذي يتم ترتيب النتائج حسبه. القيم المسموح بها هي: notification_handler_id, datetime, last_datetime, name |
| order_type | اختياري سلسلة | ترتيب النتائج. القيم المسموح بها هي: ASC للترتيب التصاعدي، و DESC للترتيب التنازلي |
| page | اختياري عدد صحيح | رقم الصفحة التي ترغب في النتائج منها. تفترض 1 |
| results_per_page | اختياري عدد صحيح | كم عدد النتائج التي تريد لكل صفحة. القيم المسموح بها هي: 10, 25, 50, 100, 250, 500, 1000. القيم الافتراضية هي 25 |
{
"data": [
{
"id": 1,
"type": "email",
"name": "Work email",
"settings": {
"email": "[email protected]"
},
"is_enabled": true,
"last_datetime": null,
"datetime": "2026-07-18 15:26:22",
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://tistos.com/api/notification-handlers?page=1",
"last": "https://tistos.com/api/notification-handlers?page=1",
"next": null,
"prev": null,
"self": "https://tistos.com/api/notification-handlers?page=1"
}
}
GET https://tistos.com/api/notification-handlers/{notification_handler_id}
curl --request GET \
--url 'https://tistos.com/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://tistos.com/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \
{
"data": {
"id": 1,
"type": "email",
"name": "Work email",
"settings": {
"email": "[email protected]"
},
"is_enabled": true,
"last_datetime": null,
"datetime": "2026-07-18 15:26:22",
}
}
POST https://tistos.com/api/notification-handlers
| المعلمات | تفاصيل | وصف |
|---|---|---|
| name | مطلوب سلسلة | - |
| type | مطلوب سلسلة | القيم المسموح بها: email, webhook, slack, discord, telegram, microsoft_teams, x, google_chat |
| اختياري سلسلة | متوفر عندما: type = email البريد الإلكتروني | |
| webhook | اختياري سلسلة | متوفر عندما: type = webhook رابط Webhook |
| slack | اختياري سلسلة | متوفر عندما: type = slack رابط Slack webhook |
| discord | اختياري سلسلة | متوفر عندما: type = discord رابط Discord webhook |
| telegram | اختياري سلسلة | متوفر عندما: type = telegram رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| telegram_chat_id | اختياري سلسلة | متوفر عندما: type = telegram معرّف دردشة Telegram |
| microsoft_teams | اختياري سلسلة | متوفر عندما: type = microsoft_teams رابط Microsoft Teams webhook |
| google_chat | اختياري سلسلة | متوفر عندما: type = google_chat عنوان URL لويب هوك Google Chat |
| x_consumer_key | اختياري سلسلة | متوفر عندما: type = x رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| x_consumer_secret | اختياري سلسلة | متوفر عندما: type = x رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| x_access_token | اختياري سلسلة | متوفر عندما: type = x رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| x_access_token_secret | اختياري سلسلة | متوفر عندما: type = x رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
curl --request POST \
--url 'https://tistos.com/api/notification-handlers' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example' \
--form 'type=email' \
--form 'email=[email protected]' \
--url 'https://tistos.com/api/notification-handlers' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example' \
--form 'type=email' \
--form 'email=[email protected]' \
{
"data": {
"id": 1
}
}
POST https://tistos.com/api/notification-handlers/{notification_handler_id}
| المعلمات | تفاصيل | وصف |
|---|---|---|
| name | اختياري سلسلة | - |
| type | اختياري سلسلة | القيم المسموح بها: email, webhook, slack, discord, telegram, microsoft_teams, x, google_chat |
| اختياري سلسلة | متوفر عندما: type = email البريد الإلكتروني | |
| webhook | اختياري سلسلة | متوفر عندما: type = webhook رابط Webhook |
| slack | اختياري سلسلة | متوفر عندما: type = slack رابط Slack webhook |
| discord | اختياري سلسلة | متوفر عندما: type = discord رابط Discord webhook |
| telegram | اختياري سلسلة | متوفر عندما: type = telegram رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| telegram_chat_id | اختياري سلسلة | متوفر عندما: type = telegram معرّف دردشة Telegram |
| microsoft_teams | اختياري سلسلة | متوفر عندما: type = microsoft_teams رابط Microsoft Teams webhook |
| google_chat | اختياري سلسلة | متوفر عندما: type = google_chat عنوان URL لويب هوك Google Chat |
| x_consumer_key | اختياري سلسلة | متوفر عندما: type = x رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| x_consumer_secret | اختياري سلسلة | متوفر عندما: type = x رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| x_access_token | اختياري سلسلة | متوفر عندما: type = x رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| x_access_token_secret | اختياري سلسلة | متوفر عندما: type = x رمز واجهة برمجة التطبيقات الخاصة بـ Telegram |
| is_enabled | اختياري قيمة منطقية | - |
curl --request POST \
--url 'https://tistos.com/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example new name' \
--form 'is_enabled=1' \
--url 'https://tistos.com/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example new name' \
--form 'is_enabled=1' \
{
"data": {
"id": 1
}
}
DELETE https://tistos.com/api/notification-handlers/{notification_handler_id}
curl --request DELETE \
--url 'https://tistos.com/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://tistos.com/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \