یک مُهر زمانی API نیاز به قرارداد زمانی خود دارد: UTC، یک آفست صریح یا یک تفسیر محلی مستند. زمان بدون منطقه نمی‌تواند به‌صورت ایمن فرض شود که همان لحظه را در تمام سیستم‌ها نشان میدهد.
مقدار خام زمان را نگه دارید
مقدار اصلی مُهر زمانی را نگه دارید و معنی قرارداد را حفظ کنید. فقط برای نمایش با یک تفسیر تعریف‌شده تبدیل کنید، نه یک پیش‌فرض مستند نشده.
آزمون مرزها
تغییرات تاریخ و فیلتر کردن دامنه را با مثال‌های مجاز بررسی کنید. RFC 3339 مرجعی برای قالب مُهر زمانی فراهم می‌کند؛ قرارداد واقعی API هنوز مقادیر پذیرفته‌شده را تعیین می‌کند.
| موضوع بررسی | مدرک یا دادهٔ لازم | کاربرد در تصمیم |
|---|---|---|
| اصلی | مُهر زمانی خام | شواهد را حفظ کنید |
| قرارداد | UTC یا آفست مستند | لحظه را تعریف کنید |
| تبدیل | منطقه هدف صریح | از پیش‌فرض‌های توضیح‌داده‌نشده پرهیز کنید |
| دامنه | قانون مرزی | تغییرات تاریخ را آزمایش کنید |
خانهٔ خالی در این کاربرگ، سؤال بی‌پاسخ است؛ آن را نتیجهٔ مثبت یا منفی فرض نکنید. مدرک موجود را از ادعا و فرض جدا نگه دارید.
یک مثال فرضی
فرض کنید دو سیستم همان ارقام ساعت را نشان می‌دهند اما از مناطق مختلف استفاده می‌کنند. برابری متن برابری لحظات را ثابت نمیکند.
قرارداد واقعی API پیاده‌سازی را تعیین می‌کند
مستندات جاری ارائه‌دهنده را بگیرید و در صورت امکان با دادهٔ آزمایشی مجاز بررسی کنید. نسخه، معنای فیلد، واحد، پاسخ خطا و شرایط دسترسی را ثبت کنید. مثال این متن مفهومی است؛ نام endpoint رهگارد یا وعدهٔ قابلیت اتصال نیست. اطلاعات محرمانهٔ دسترسی را در نمونه، لاگ و کد مرورگر قرار ندهید. پیش از تکرار عملیات تغییردهنده، وضعیت نتیجهٔ قبلی را روشن کنید.
مطالعهٔ تکمیلی: ساعت ردیاب اشتباه است؟ زمان دستگاه، GPS و سرور را جدا کنید و خروجی تاریخچه مسیر ردیاب؛ CSV، Excel یا PDF؟.
برای بررسی دستگاه و مسیر رسمی خدمات، به رهگارد و فروشگاه ردیاب خودرو مراجعه کنید؛ امکانات و شرایط همان مدل را پیش از سفارش تأیید کنید.
هنوز دیدگاهی ثبت نشده. اولین نفر باشید!