Skip to main content
#P1625

POST /v2/redis-accounting/create-missing-documents

Create Missing Documents

این اندپوینت در سرویس Redis Accounting وظیفه دارد همه مدارکی که باید وجود داشته باشند اما در Redis ثبت نشده‌اند را شناسایی و ایجاد کند. این عملیات معمولاً در موارد زیر استفاده می‌شود:

  • بازسازی داده‌های از دست رفته
  • یکپارچه‌سازی وضعیت حساب‌ها
  • رفع inconsistency بین DB و Redis

Request Overview

URL: /v2/redis-accounting/create-missing-documents
Method: POST
Auth: Bearer Token (Required)
Content-Type: application/json

Request Body Schema

Field Type Required Description
organization_id integer yes شناسه سازمانی که باید مدارک آن بررسی و تکمیل شود
sync_mode string no نوع همگام‌سازی. مقادیر مجاز: full, delta
dry_run boolean no اگر true باشد، فقط موارد گم‌شده شناسایی می‌شود ولی ایجاد نمی‌شود

Request Example

{
  "organization_id": 1204,
  "sync_mode": "delta",
  "dry_run": false
}
  

Response Schema

Field Type Description
status string وضعیت اجرای عملیات (success یا failed)
created_count integer تعداد مدارک جدیدی که ایجاد شده‌اند
missing_ids array لیست شناسه‌هایی که گم شده بودند (در حالت dry_run همیشه پر است)
execution_time_ms integer مدت زمان اجرای فرآیند بر حسب میلی‌ثانیه

Response Example

{
  "status": "success",
  "created_count": 32,
  "missing_ids": [
    "redis:doc:93422",
    "redis:doc:93424",
    "redis:doc:93455"
  ],
  "execution_time_ms": 128
}
  

Process Flow

Start Request
Load organization_id
Compare Database vs Redis
Identify Missing Documents
dry_run ? return diff : create documents
Return Response