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