API کے ذریعے رابطہ کی تصدیق اور دوبارہ بھیجنا
ICANN کے ضوابط کے مطابق ڈومین کے رابطہ معلومات کی تصدیق لازمی ہے۔ آپ ان عملوں کو ہمارے API سروسز کے ذریعے براہِ راست اور مؤثر طریقے سے منظم کر سکتے ہیں، بغیر کنٹرول پینل میں لاگ اِن کیے۔
1. ڈومین تصدیقی اسٹیٹس کی جانچ
کسی ای میل ایڈریس کی تصدیقی حیثیت، میعاد اور نوٹیفکیشن ہسٹری چیک کرنے کے لیے آپ کو ContactApi.svc کے تحت GetDetails میتھڈ استعمال کرنا ہوگا۔
اہم تکنیکی تفصیلات:
- مدتِ اعتبار: تصدیقی کلید 60 دن تک کارآمد رہتی ہے۔
- دائرہ کار: یہ میتھڈ متعلقہ رابطہ معلومات، موجودہ تصدیقی اسٹیٹس، اور آخری بھیجے گئے نوٹیفکیشن کی تاریخ واپس کرتا ہے۔
تکنیکی حوالہ جات:
درخواست کے دوران استعمال ہونے والے ماڈل اسٹرکچر اور اسٹیٹس کوڈز کے لیے آپ درج ذیل تازہ فہرست دیکھ سکتے ہیں:
- تصدیقی معلومات ماڈل: https://paste.ubuntu.com/p/HDyrdRvh2D/
تصدیقی اسٹیٹس
درخواست کے نتیجے میں ملنے والے بنیادی اسٹیٹس کوڈز درج ذیل ہیں:
| اسٹیٹس | وضاحت |
| NotValidated | تصدیق کا عمل ابھی تک مکمل نہیں ہوا۔ |
| Validated | ای میل ایڈریس کامیابی سے تصدیق ہو چکا ہے۔ |
| Pending | تصدیق کا عمل جاری ہے / زیرِ انتظار ہے۔ |
| Expired | 60 دن کی تصدیقی کلید کی مدت ختم ہو چکی ہے۔ |
2. API کے ذریعے تصدیقی ای میل دوبارہ بھیجنا
آپ API کے ذریعے ڈومین کے مالک کو تصدیقی ای میل فوراً بھیج سکتے ہیں۔ اس مقصد کے لیے ContactApi.svc کے تحت ResendContactVerificationNotice میتھڈ استعمال ہوتا ہے۔
یہ میتھڈ دو مختلف اختیاری پیرا میٹر قبول کرتا ہے:
- رابطہ ای میل: آپ گاہک کا ای میل ایڈریس براہِ راست درج کر سکتے ہیں۔ سسٹم اسی ایڈریس کی بنیاد پر درخواست پر عمل کرے گا۔
- External ID: آپ ڈومین سے منسلک رابطہ ہینڈل آئی ڈی (مثلاً DNA-111) فراہم کر سکتے ہیں۔ سسٹم اس آئی ڈی سے منسلک ای میل معلومات ڈیٹابیس سے حاصل کرتا ہے اور اگر ای میل ابھی تصدیق شدہ نہ ہو تو نوٹیفکیشن دوبارہ بھیجتا ہے۔
نوٹ: نوٹیفکیشن ای میل ٹرگر ہوتے ہی فوراً بھیج دی جاتی ہے اور قطار میں شامل نہیں ہوتی۔
نمونہ ڈیٹا ماڈل
عمل مکمل ہونے کے بعد واپس آنے والا ڈیٹا اسٹرکچر درج ذیل ہے:
{
"VerificationStatus": "NotValidated",
"ExpirationDate": "2026-04-05T10:00:00",
"LastNotificationDate": "2026-02-05T09:30:00",
"ContactEmail": "example@customer.com"
}
