ارسال دوباره‌ی رویدادهای ناموفق

POST/v1/webhooks/replay-failed

همه‌ی رویدادهای ناموفق یک بازه را، از رویدادهای انتخاب‌شده، دوباره می‌فرستد. حداکثر 7 روز و 500 رویداد. from جزو بازه است و to نیست.

دسترسی لازم

read

سقف نرخ در دقیقه

5 برای هر سازمان

درخواست

curl

curl -X POST 'https://api.romu.ir/v1/webhooks/replay-failed' \
  -H "X-Custody-Key-Id: $KEY_ID" \
  -H "X-Custody-Timestamp: $TIMESTAMP" \
  -H "X-Custody-Nonce: $NONCE" \
  -H "X-Custody-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "2026-10-05T00:00:00Z",
    "to": "2026-10-06T00:00:00Z"
  }'

TypeScript

import { romu } from "./romu.ts";

const res = await romu.post("/v1/webhooks/replay-failed", {
  json: {
    "from": "2026-10-05T00:00:00Z",
    "to": "2026-10-06T00:00:00Z"
  },
});
console.log(res.status, res.body);

Go

status, body, err := client.Do("POST", "/v1/webhooks/replay-failed", "", []byte(`{"from":"2026-10-05T00:00:00Z","to":"2026-10-06T00:00:00Z"}`), "")

Python

import romu

status, body = romu.post(
    "/v1/webhooks/replay-failed",
    json={
      "from": "2026-10-05T00:00:00Z",
      "to": "2026-10-06T00:00:00Z"
    },
)
print(status, body)

امضای درخواست را کتابخانه انجام می‌دهد؛ جزئیات: صفحه‌ی امضا

بدنه

fromRFC 3339لازم

toRFC 3339لازم

فیلد ناشناخته در بدنه 400 می‌گیرد.

پاسخ

200تعداد رویدادهایی که دوباره فرستاده شدند.

نمونه

{
  "replayed": 12
}

فیلدها

replayedintegerلازم

خطاها

400invalid request یا malformed request body⁠: بدنه، پارامتر یا فیلد نادرست است، یا فیلد ناشناخته دارد.

401unauthenticated⁠: هر شکست احراز هویت همین پاسخ را دارد.

403permission denied⁠: کلید دسترسی این مسیر را ندارد.

409Webhook خاموش است (the organisation's webhook is off⁠)، رویداد هنوز در صف ارسال است، یا نوع رویداد انتخاب نشده است.

429too many requests⁠: بیش از سقف نرخ. پس از Retry-After ثانیه دوباره بفرستید.

503try again later⁠: سرویس موقتاً در دسترس نیست.

بدنه‌ی خطا همیشه {"error":"..."} است. راهنمای خطاها می‌گوید برای هر کد چه باید کرد.