پرش به محتوای اصلی

provider automation

تکرار امن درخواست و شمارش سهمیهٔ اتوماسیون

سیگنال ناموفق را بی‌خطر دوباره بفرست و بدان سهمیهٔ اتوماسیون چه چیزی را می‌شمارد.

/help/signal-api-quota-and-retriesآخرین به‌روزرسانی۳۱ شهریور ۱۴۰۵
  1. مرحله ۱

    باز کردن «بیشتر»

    در پنل، در نوار پایین «بیشتر» را بزن. روی دسکتاپ همین گروه‌ها در نوار کناری‌اند.

  2. مرحله ۲

    رفتن به ابزار حرفه‌ای

    در گروه «ابزار معامله» روی «Professional Tools» بزن.

  3. مرحله ۳

    پیدا کردن شمارنده

    در کارت «API و وب‌هوک سیگنال»، اولین خط زیر جملهٔ توضیح شمارندهٔ توست. در سطح ۴ به‌جای آن «سهمیهٔ اتوماسیون: نامحدود» را می‌بینی.

    نمونهسهمیهٔ اتوماسیون این دوره: ۱۲ از ۳۰

  4. مرحله ۴

    بدان چه چیزی خرج می‌شود

    فقط انتشاری که واقعاً سیگنال می‌سازد یک واحد از سهمیه برمی‌دارد؛ خطاها، ۴۲۹ها و تکراری‌ها رایگان‌اند.

  5. مرحله ۵

    ساختن شناسهٔ یکتا

    برای هر سیگنال یک externalSignalId یکتا بساز و پیش از ارسال ذخیره‌اش کن.

  6. مرحله ۶

    تکرار با همان شناسه

    اگر درخواست قطع شد، همان بدنه را با همان externalSignalId دوباره بفرست. جواب ۲۰۱ است، با همان signalId اول.

    نمونهidempotent: true

  7. مرحله ۷

    خواندن سهمیه از کد

    همین وضعیت را با هدر x-sigrah-provider-key و بدون باز کردن پنل بگیر.

    نمونهGET https://api.sigrah.ir/api/v1/provider-api/status

می‌دانی چقدر از سهمیهٔ این دوره مانده و هر ارسال ناموفق را بی‌خطر تکرار می‌کنی. ملاک تشخیص تکراری همان externalSignalId است، پس فرستادن دوباره هیچ‌وقت سیگنال دوم نمی‌سازد.

برچسب‌هاsignal-apiquotaidempotencyretry