التوثيق/البدء السريع

البدء السريع

انتقلوا من الصفر إلى بريد إلكتروني موثّق في أقل من 5 دقائق.

عرض Markdown OpenAPI JSON

1. أنشئوا حسابكم

سجّلوا عبر verimails.com/register دون الحاجة إلى بطاقة ائتمان. ستحصلون على 100 رصيد مجاني فورًا.

2. احصلوا على مفتاح API

بعد تسجيل الدخول، انتقلوا إلى لوحة التحكم وانسخوا مفتاح API الخاص بكم. يبدو على النحو التالي:

text
ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ℹ️
احتفظوا بمفتاح API سرًّا. لا تكشفوه أبدًا في الشيفرة من جهة العميل أو في المستودعات العامة.

3. أرسلوا طلبكم الأول

أرسلوا طلب POST إلى /api/verify/single مع عنوان بريد إلكتروني:

bash
curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
python
import requests

response = requests.post(
    "https://verimails.com/api/verify/single",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"email": "user@example.com"}
)

data = response.json()
print(data["status"])         # valid
print(data["safe_to_send"])  # True
javascript
const response = await fetch("https://verimails.com/api/verify/single", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ email: "user@example.com" })
});

const data = await response.json();
console.log(data.status);        // valid
console.log(data.safe_to_send);  // true
php
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://verimails.com/api/verify/single",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => json_encode(["email" => "user@example.com"])
]);

$response = json_decode(curl_exec($ch), true);
echo $response["status"];        // valid
echo $response["safe_to_send"];  // 1

4. افهموا الاستجابة

تبدو الاستجابة الناجحة على النحو التالي:

json
{
  "email": "user@example.com",
  "status": "valid",
  "safe_to_send": true,
  "confidence_score": 0.95,
  "reason": "Verification completed",
  "domain": "example.com",
  "is_disposable": false,
  "is_role_based": false,
  "is_free": true,
  "is_catch_all": false,
  "verification_time_ms": 642
}

أهم الحقول هي status و safe_to_send. استخدموا safe_to_send: true كمرشّح أساسي لتحديد ما إذا كنتم ستتواصلون مع عنوان ما.

الخطوات التالية