API استعلام اینماد

فروشنده‌ای در بازارگاه شما ثبت‌نام می‌کند و آدرس فروشگاهش را وارد می‌کند. یک فراخوان با همان آدرس می‌گوید برای آن دامنه نماد اعتماد الکترونیکی هست یا نه، به نام چه کسی است و تا کی اعتبار دارد.

پاسخ دو لایه دارد: وضعیت (expired، message) و اطلاعات هویتی (name، nameper، state_name، city_name). فرم ثبت‌نام شما معمولاً فقط لایهٔ اول را لازم دارد، ولی لایهٔ دوم برای مقایسه با نام ثبت‌شده در پرونده فروشنده به کار می‌آید.

ورودی چه‌قدر باید تمیز باشد

ورودی فقط website است و خودِ سرویس https://، www. و هر مسیر بعد از دامنه را حذف می‌کند و حروف را کوچک می‌کند. زیردامنهٔ غیر از www می‌ماند، پس shop.example.com و example.com دو دامنهٔ جدا حساب می‌شوند. نشانی بدون نقطه یا با نویسهٔ نامعتبر همان‌جا invalid_input می‌شود و هزینه ندارد.

خواندن پاسخ

تاریخ‌ها approve_date و expiry_date رشته‌اند، expired بولی است و logolevel عدد است. هر دو را بخوانید: expired برچسب سرویس مرجع است و expiry_date تاریخ دقیق؛ در نمایش به کاربر تاریخ را هم نشان دهید. message متنی مثل «نماد دارد.» است و برای شرط کد به کار نمی‌آید. فیلد srv_text یک رشته است که رسته‌ها را با ویرگول جدا می‌کند و آخرش هم ویرگول می‌ماند، با فاصلهٔ اضافی در میان واژه‌ها. پیش از مقایسه، با ویرگول بشکنید، فاصله‌ها را تمیز کنید و آیتم خالی را دور بیندازید. در نمونهٔ پاسخ، name فاصلهٔ انتهایی هم دارد.

هزینه و تازگی

پاسخ تا حدود یک روز ممکن است از کش بیاید؛ source.cached و source.fetchedAt را ببینید. اگر نمادی دقیقاً امروز منقضی شده باشد، پاسخ کش‌شدهٔ دیروز هنوز expired: false می‌گوید، پس برای تصمیم حساس، expiry_date را با تاریخ امروز مقایسه کنید.

چه چیزی را نمی‌دهد

کیفیت خدمات فروشگاه، رضایت مشتریان و شکایت‌های ثبت‌شده در پاسخ نیست. نماد داشتن یعنی مراحل اخذ طی شده، نه اینکه فروشگاه خوب است. این سرویس مالکیت دامنه را هم نشان نمی‌دهد: اینکه کاربر ثبت‌نام‌کننده همان دارندهٔ نماد است یا نه را باید با نام حقوقی و مدارک خودتان تطبیق دهید.