الأمان والثقة · منتج DomScan

API الخاص بـ القائمة السوداء للبريد الإلكتروني

تحقق مما إذا تم إدراج مجال أو IP في قوائم البريد الإلكتروني السوداء.

ما الذي تحصل عليه

تحقق مما إذا تم إدراج مجال أو IP في قوائم البريد الإلكتروني السوداء.

متزامنمجمّعRESTMCPSDKأداة تفاعلية

اختر هذا المنتج عندما

لمن صُمم هذا المنتج

استخدم الفحوصات السلبية المحدودة لإثراء الفرز والتحقيق، لا لاستبدال الاختبار المصرّح به أو المراجعة البشرية.

اختر هذا المنتج عندما

اختره لفحص أدلة القوائم السوداء المدعومة في وقت محدد. النتيجة النظيفة ليست ضمانًا شاملًا للسمعة.

ما الذي تحصل عليه

تحقق مما إذا تم إدراج مجال أو IP في قوائم البريد الإلكتروني السوداء.

نقاط النهاية

راجع العمليات والمدخلات والمخرجات وأنماط التنفيذ وحدود الاستجابة المدعومة قبل التكامل.

GET /v1/email/check عرض مرجع API
POST /v1/email/check/bulk عرض مرجع API
GET /v1/email/blacklist عرض مرجع API
GET /v1/email/blacklist/download عرض مرجع API

الوحدات والمصادقة

0-1 المصادقة مطلوبة. راجع مرجع العملية لمعرفة التكلفة الدقيقة وتسعير كل عنصر إن وُجد.

مثال على عملية

استخدم العمليات الموثقة لجمع الأدلة العامة أو تقييمها أو إثرائها أو التحقق منها أو مقارنتها أو حمايتها أو مراقبتها.

GET /v1/email/check الرصيد: 1

معاملات الاستعلام

المعامل النوع مطلوب
email string مطلوب
checks string اختياري

حقول الرد

الحقل النوع
email string
domain string
local_part string
valid_syntax boolean
checks object
checks.disposable object
checks.disposable.is_disposable boolean
checks.disposable.confidence string | null
checks.disposable.matched_pattern string
checks.role object
checks.role.is_role boolean
checks.role.role_type string | null
checks.free object
checks.free.is_free boolean
checks.free.provider string | null
checks.mx object
checks.mx.has_mx boolean | null
checks.mx.records[] string[]
checks.mx.null_mx boolean
checks.dnsbl object
checks.dnsbl.domain string
checks.dnsbl.ip string
checks.dnsbl.listed boolean
checks.dnsbl.lists[] object[]
checks.dnsbl.lists[] object
checks.dnsbl.lists[].name string
checks.dnsbl.lists[].listed boolean
checks.dnsbl.lists[].status string
checks.dnsbl.lists[].code string
checks.dnsbl.lists[].meaning string
checks.dnsbl.lists[].unknown_reason string
checks.dnsbl.lists_unknown integer
checks.dnsbl.threat_level string
checks.dnsbl.check_type string
checks.dnsbl.checked_at string
risk_score integer
risk_level string
flags[] string[]
checked_at string

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl"
const response = await fetch("https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

مثال الرد

{
  "email": "[email protected]",
  "domain": "acme-widgets.com",
  "local_part": "support",
  "valid_syntax": true,
  "checks": {
    "disposable": {
      "is_disposable": false,
      "confidence": null
    },
    "role": {
      "is_role": true,
      "role_type": "support"
    },
    "free": {
      "is_free": false,
      "provider": null
    },
    "mx": {
      "has_mx": true,
      "records": [
        "mx1.mailhost-example.net",
        "mx2.mailhost-example.net"
      ]
    },
    "dnsbl": {
      "listed": false,
      "threat_level": "none"
    }
  },
  "risk_score": 20,
  "risk_level": "low",
  "flags": [
    "ROLE_ADDRESS"
  ],
  "checked_at": "2026-10-09T10:15:30.000Z"
}

رموز حالة HTTP

  • 200 OK
  • 400 طلب غير صالح
  • 401 غير مصرح
  • 402 الدفع مطلوب
  • 429 طلبات كثيرة جداً

الأسئلة الشائعة

أين أجد مرجع طلب واستجابة القائمة السوداء للبريد الإلكتروني؟

استخدم مرجع API الخاص بـ القائمة السوداء للبريد الإلكتروني لمراجعة المعاملات وحقول الاستجابة والأمثلة ورموز الحالة وأنماط التشغيل المدعومة.

كيف أفسر النتائج غير المعروفة أو غير المكتملة من القائمة السوداء للبريد الإلكتروني؟

تعني النتائج غير المعروفة أو الجزئية أن الأدلة المطلوبة لم تُحسم بالكامل. احتفظ بحالة النتيجة ومستوى الثقة والحداثة والحدود عند اتخاذ القرارات اللاحقة.

كيف يتم احتساب سعر القائمة السوداء للبريد الإلكتروني؟

تختلف الأسعار حسب العملية ونمط التنفيذ. راجع مرجع نقطة النهاية لمعرفة التكلفة الحالية ومتطلبات المصادقة وقواعد التسعير لكل عنصر.

يستخدمه أشخاص في هذه الشركات

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse