مرجع المطورين

قائمة مراقبة النطاق

باستخدام DomScan API، مراقبة النطاقات لانتهاء الصلاحية والتغييرات في التوفر. احصل على تنبيهات عند أن تصبح النطاقات المسجلة متاحة.

قائمة مراقبة النطاق

مراقبة النطاقات لانتهاء الصلاحية والتغييرات في التوفر. احصل على تنبيهات عند أن تصبح النطاقات المسجلة متاحة.

المراقبة

سجّل الدخول باستخدام Google للوصول إلى قائمة مراقبة نطاقاتك الشخصية مع تنبيهات البريد الإلكتروني وwebhooks وغير ذلك.

تلقي الإشعارات عبر البريد الإلكتروني أو Telegram أو Slack أو Discord أو Webhook.

المراقبة الإعدادات مراقب العلامة التجارية

GET /v1/watchlist

احصل على جميع النطاقات في قائمة المراقبة الخاصة بك.

مثال الرد

{
                "watchlist": [
                {
                "domain": "startup.com",
                "added_at": "2024-01-15T10:30:00Z",
                "status": "registered",
                "expiry_date": "2025-01-15T00:00:00Z",
                "days_until_expiry": 287,
                "last_checked": "2024-03-01T12:00:00Z",
                "notify_email": "[email protected]",
                "check_count": 4
                }
                ],
                "total": 1,
                "updated_at": "2024-03-01T12:00:00Z"
                }

حقول الرد

الحقل	النوع
`watchlist[]`	object[]
`watchlist[]`	object
`watchlist[].domain`	string
`watchlist[].added_at`	string
`watchlist[].status`	string
`watchlist[].last_checked`	string
`watchlist[].expiry_date`	string
`watchlist[].days_until_expiry`	integer
`watchlist[].notify_email`	string
`total`	integer
`updated_at`	string

POST /v1/watchlist

أضف نطاقاً إلى قائمة المراقبة الخاصة بك.

نص الطلب

{
                "domain": "mydomain.com",
                "notify_email": "[email protected]"
                }

حقول الرد

الحقل	النوع
`success`	boolean
`message`	string
`watchlist[]`	object[]
`watchlist[]`	object
`watchlist[].domain`	string
`watchlist[].added_at`	string
`watchlist[].status`	string
`watchlist[].last_checked`	string
`watchlist[].expiry_date`	string
`watchlist[].days_until_expiry`	integer
`watchlist[].notify_email`	string
`total`	integer

مثال الرد

{
  "success": true,
  "message": "string",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1
}

DELETE /v1/watchlist?domain=mydomain.com

إزالة من قائمة المراقبة

curl -X DELETE -H "X-API-Key: your-api-key" "https://domscan.net/v1/watchlist?domain=mydomain.com"

حقول الرد

الحقل	النوع
`success`	boolean
`message`	string
`domain`	string

مثال الرد

{
  "success": true,
  "message": "string",
  "domain": "example.com"
}

GET /v1/watchlist/expiring?days=30

تنتهي قريباً

مثال الرد

{
                "expiring_domains": [
                {
                "domain": "renewal-window.com",
                "status": "expiring_soon",
                "expiry_date": "2026-05-12T00:00:00Z",
                "days_until_expiry": 28,
                "check_count": 11
                }
                ],
                "total": 1,
                "threshold_days": 30
                }

حقول الرد

الحقل	النوع
`expiring_domains[]`	object[]
`expiring_domains[]`	object
`expiring_domains[].domain`	string
`expiring_domains[].added_at`	string
`expiring_domains[].status`	string
`expiring_domains[].last_checked`	string
`expiring_domains[].expiry_date`	string
`expiring_domains[].days_until_expiry`	integer
`expiring_domains[].notify_email`	string
`total`	integer
`threshold_days`	integer

GET /v1/watchlist/available

متاح

مثال الرد

{
                "available_domains": [
                {
                "domain": "startupdrop.ai",
                "status": "available",
                "last_checked": "2026-04-14T08:30:00Z",
                "check_count": 18
                }
                ],
                "total": 1,
                "message": "هذه النطاقات من قائمة المراقبة الخاصة بك متاحة الآن للتسجيل!"
                }

حقول الرد

الحقل	النوع
`available_domains[]`	object[]
`available_domains[]`	object
`available_domains[].domain`	string
`available_domains[].added_at`	string
`available_domains[].status`	string
`available_domains[].last_checked`	string
`available_domains[].expiry_date`	string
`available_domains[].days_until_expiry`	integer
`available_domains[].notify_email`	string
`total`	integer
`message`	string