API التحقق من عناوين البريد الإلكتروني
تحقق من قوائم البريد برمجياً — ارتداد أقل وقابلية تسليم أفضل
اربط نماذج التسجيل وCRM وصفحات الهبوط بـ EmailVerifier. تحقق من عناوين البريد عبر REST API فورياً أو bulk job — فوترة شفافة 1 request = 1 credit.
- تحقق فوري
- Bulk حتى 50,000 بريد
- 1 طلب = 1 رصيد
مثال طلب
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_…" \
-d '{"email":"user@company.com"}'قاعدة معرفة API
اختر موضوعاً — من المصادقة والرصيد إلى bulk وwebhooks وأكواد الأخطاء.
POST /verify — عنوان واحد، نتيجة أقل من ثانية، حالة valid/invalid/risky.
اقرأ المزيدAPIالتحقق bulk من البريدتحقق جماعي من CSV — طابور مهام، polling للتقدم وتصدير CSV.
اقرأ المزيدAPIالرصيد والفوترةالرصيد، استخدام API، 1 credit = 1 تحقق، معالجة HTTP 402.
اقرأ المزيدAPIمفاتيح API والمصادقةBearer ev_live_، لوحة الرموز، أفضل ممارسات تخزين المفتاح.
اقرأ المزيدAPIWebhooks والتكاملاتverification.completed، توقيع HMAC، CRM وأتمتة التسويق.
اقرأ المزيدAPIمرجع OpenAPIمواصفات YAML كاملة، Redoc UI وفهرس أخطاء HTTP.
اقرأ المزيدما هو API التحقق من البريد؟
واجهة REST للتحقق من العناوين قبل إرسال الحملات.
API التحقق من البريد يفحص ما إذا كان العنوان موجوداً، وهل النطاق يقبل البريد، وهل الصندوق disposable أو catch-all. تقلل معدل الارتداد وتحمي سمعة المرسل وتحسّن الوصول للصندوق الوارد.
API يُقدَّم عبر HTTPS على /api/v1. صادق بمفتاح Bearer (ev_live_…) أو جلسة اللوحة. كل POST /verify ناجح يكلف credit واحداً — بدون اشتراك وبدون رسوم مخفية على GET.
متى تستخدم API التحقق من البريد
سيناريوهات تكامل شائعة في منتجات B2B ومكدسات التسويق.
نماذج التسجيل
تحقق من البريد فورياً عند التسجيل — ارفض invalid و disposable قبل الإدراج.
CRM وجمع العملاء المحتملين
نظّف العملاء من صفحات الهبوط وwebhooks — فقط العناوين القابلة للتسليم تدخل pipeline.
تنظيف القوائم قبل الحملات
Bulk API قبل النشرات — ارتداد أقل ومعدل فتح أعلى وتكلفة ESP أقل.
منصات SaaS
ادمج فحص البريد في منتجك — الفوترة بالرصيد تبسّط تسعير العملاء.
نموذج رصيد API
تسعير بسيط: طلب تحقق واحد = credit واحد.
- POST /verify يخصم 1 credit لكل طلب ناجح (HTTP 200) بمفاتيح ev_live_، حتى لو تحقق من نفس العنوان سابقاً عبر API. مفاتيح sandbox (ev_test_) تعيد mock بدون خصم.
- عمليات GET — الرصيد، السجل، حالة bulk job، تصدير CSV — مجانية.
- الرصيد غير الكافي يعيد HTTP 402 (insufficient_credits). أخطاء المحرك (503) لا تخصم credit.
المصادقة ومفاتيح API
وصول آمن عبر رأس Authorization.
- سجّل الدخول للوحة وافتح API tokens (/account/api).
- أنشئ مفتاح إنتاج (ev_live_) أو sandbox (ev_test_) — يُعرض secret كاملاً مرة واحدة فقط.
- أرسل المفتاح كـ Authorization: Bearer ev_live_… — أبداً في URLs أو كود العميل.
Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/jsonبدء سريع — API التحقق من البريد
استدعاءان: فحص الرصيد وأول تحقق.
1. فحص رصيد الرصيد
curl https://propercheck.pl/api/v1/credits \
-H "Authorization: Bearer ev_live_YOUR_KEY"2. التحقق من عنوان بريد واحد
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"john@company.com"}'تحقق فردي (فوري)
POST /api/v1/verify يقبل JSON بحقل email. الاستجابة تشمل status و score 0–100 و provider (Google, Microsoft, regional hosts) و enrichment (MX, catch-all).
POST /api/v1/verify
بنية استجابة JSON
الحقول المُرجعة بعد تحقق ناجح.
{
"verificationId": "ver_abc123",
"email": "john@company.com",
"status": "valid",
"score": 92,
"provider": "google",
"enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
"creditsRemaining": 149
}حالات التحقق من البريد
التصنيف المستخدم في API واللوحة وتصدير CSV.
valid
valid — العنوان موجود ويقبل البريد؛ آمن للإرسال.
invalid
invalid — العنوان غير موجود أو النطاق بلا بريد؛ أزل من القائمة.
risky
risky — ثقة منخفضة (مثل disposable، role account)؛ حذر في الحملات.
catch_all
catch_all — الخادم يقبل كل عناوين النطاق؛ خطر ارتداد أعلى.
unknown
unknown — استجابة SMTP غير حاسمة؛ فكّر بإعادة التحقق لاحقاً.
مرجع نقاط REST
قائمة مسارات API v1 كاملة مع تكلفة credit.
| الطريقة | المسار | الرصيد | الوصف |
|---|---|---|---|
| POST | /verify | 1 | تحقق بريد فردي فوري |
| GET | /verify/:id | 0 | جلب النتيجة بـ verificationId |
| GET | /verifications | 0 | سجل التحقق وإحصائيات 30 يوماً |
| GET | /credits | 0 | رصيد الحساب الحالي |
| POST | /bulk | N | إنشاء bulk job (N رصيد) |
| GET | /bulk/:id | 0 | حالة وتقدم bulk job |
| GET | /bulk/:id/export | 0 | تنزيل النتائج CSV |
| GET/POST/PATCH/DELETE | /api-keys | 0 | إدارة رموز API (جلسة) |
| GET/POST/DELETE | /webhooks | 0 | إعداد webhooks (جلسة) |
| GET | /usage | 0 | إحصائيات استخدام API والرصيد |
واجهة التحقق الجماعي من البريد
تحقق من آلاف العناوين في job واحد — مثالي قبل حملات كبيرة.
- POST /bulk بمصفوفة emails أو نص CSV — رصيد محجوز لـ N عناوين فريدة.
- GET /bulk/:id — polling للحالة (queued → processing → completed).
- GET /bulk/:id/export — تنزيل CSV بأعمدة email و status و score و provider.
curl -X POST https://propercheck.pl/api/v1/bulk \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"emails":["a@b.co","c@d.co"]}'إشعارات webhook — verification.completed
استقبل POST على URL عند اكتمال التحقق. رأس X-EV-Signature يحتوي HMAC-SHA256 للجسم — تحقق قبل المعالجة.
X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>حدود المعدل
60 طلباً في الدقيقة لكل مفتاح API افتراضياً. التجاوز يعيد HTTP 429 مع rate_limit_exceeded. الحدود per key — رموز منفصلة لكل تكامل.
رأس اختياري على POST /verify — retry آمن بدون خصم credit مزدوج (TTL 24h).
X-Request-Id
كل استجابة API تتضمن X-Request-Id — أرفقه عند التواصل مع الدعم لتصحيح التكامل.
أكواد أخطاء HTTP
| HTTP | الكود | الوصف |
|---|---|---|
| 401 | unauthorized | جلسة أو مفتاح API مفقود في الطلب. |
| 401 | invalid_api_key | مفتاح API غير صالح أو منتهٍ أو ملغى. |
| 400 | invalid_request | JSON غير صالح، حقل email مفقود أو عنوان malformed. |
| 402 | insufficient_credits | رصيد غير كافٍ — اشحن في /account/credits. |
| 429 | rate_limit_exceeded | تجاوز حد المعدل — 60 طلب/دقيقة لكل مفتاح API افتراضياً. |
| 503 | engine_unavailable | محرك التحقق غير متاح — لا يُخصم credit. |
أمثلة التكامل
نفس flow التحقق بلغات شائعة.
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"john@company.com"}'FAQ — API التحقق من البريد
أسئلة شائعة من المطورين والمسوقين.
OpenAPI 3.1 و Redoc
مواصفات machine-readable للcodegen واختبارات العقد وCI.
ابدأ التحقق من البريد عبر API
رصيد تجريبي مجاني عند التسجيل. مفتاح API في لوحتك خلال دقيقة.
أنشئ مفتاحك في لوحة الحساب.