سطح خدمات

این‌ها هدف‌هایی است که API محیط اصلی را بر پایهٔ آن‌ها اداره می‌کنیم؛ از سمت خودمان و برای هر ماه تقویمی اندازه‌گیری می‌شوند. قراردادهای محصولات داده ممکن است در صورت نرسیدن به این هدف‌ها اعتبار جبرانی بدهند؛ هر جا چنین باشد، خود قرارداد آن را می‌گوید.

این موارد در محاسبهٔ هدف‌ها به حساب نمی‌آیند:

• پاسخ‌هایی که علتشان خود درخواست است: 4xx، از جمله 429 برای محدودیت‌های نرخ و سهمیه‌ها.
• پاسخ‌های 503 با کد یکی از شرکا (escrow_unavailable، credit_unavailable، ...) در مدتی که آن شریک از دسترس خارج است. به شما می‌گوییم کدام شریک و چه زمانی برمی‌گردد.
• خطا یا کندی اندپوینت وب‌هوک شما. تلاش‌های دوباره طبق زمان‌بندی وب‌هوک‌ها انجام می‌شوند.
• محیط آزمایشی، که هنوز ارائه نمی‌شود؛ وقتی راه بیفتد، بر پایهٔ بهترین تلاش (best-effort) اداره می‌شود.
• نگهداری‌ای که دست‌کم ۷ روز زودتر اعلام شود، حداکثر ۴ ساعت در ماه، خارج از ساعت ۰۶:۰۰ تا ۲۲:۰۰ به وقت ترکیه.

وقتی مشکلی پیش می‌آید

• رخدادهایی که بر API اثر می‌گذارند، هم‌زمان با وقوع در صفحهٔ وضعیت اعلام می‌شوند و تا رفع مشکل دست‌کم هر ساعت به‌روزرسانی می‌شوند.
• به مشتریان محصولات داده مستقیماً، از طریق رابط‌هایی که در قراردادشان آمده است، خبر داده می‌شود.
• برای هر رخدادی که بیش از یک‌چهارم بودجهٔ خطای ماه را مصرف کرده باشد (حدود ۱۱ دقیقه قطعی کامل)، ظرف ۵ روز کاری گزارشی پس از رخداد منتشر می‌شود.

سهم شما

5xx و 429 را با فاصلهٔ فزاینده (backoff) و تأخیر تصادفی (jitter) دوباره امتحان کنید. پردازشگرهای وب‌هوک را سریع نگه دارید و طوری بنویسید که اجرای دوباره‌شان اثر تازه‌ای نگذارد (idempotent). X-Request-Id را ثبت کنید: با آن می‌توانیم هر درخواستی را که درباره‌اش بپرسید ردیابی کنیم.