هزینهٔ مشتری و خروجی مصرف

برچسب درخواست

X-Customer-ID و X-Reference-ID را برای اتصال مصرف به مشتری یا رکورد برنامه بفرست. حداکثر ۱۲۰ نویسه؛ از شناسهٔ داخلی استفاده کن و اطلاعات حساس را در برچسب نگذار. عامل‌ها و پردازش گروهی برچسب‌ها را روی درخواست‌های داخلی ثبت می‌کنند.

گزارش کامل

GET /v1/usage/export پارامترهای from، through، customer_id، cursor و format=csv را می‌پذیرد. بازه حداکثر ۹۰ روز است؛ هر صفحه حداکثر ۱۰۰۰ ردیف دارد. برای خروجی کامل next_cursor را ادامه بده و from/through پاسخ اول را ثابت نگه دار. CSV هدر X-Next-Cursor دارد. داشبورد مصرف تمام صفحه‌های ۳۰ روز را دریافت می‌کند.

معنی هزینه

credits شامل مقدار مصرف نهایی یا اعتبار موقت در انتظار تسویه است. pending:true یعنی تسویه هنوز تمام نشده؛ آن را فاکتور نهایی تلقی نکن. خروجی متن ورودی/پاسخ را ندارد و شامل مشتری، مرجع، عامل، batch، توکن و زمان اجراست.

بودجه

GET /v1/usage/budget سقف ماهانه، مصرف، باقی‌مانده و زمان بازنشانی را می‌دهد. سقف پروژه و کلید همچنان به‌صورت اتمی در دفتر اعتبار اعمال می‌شوند. عبور از ۸۰٪ با رویداد budget.threshold در وب‌هوک اطلاع داده می‌شود. سقف هر batch و نوبت پاسخ عامل محدودیت افزودهٔ همان جریان کار است.