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

POST

وقتی هیچ ردیفی در صف، در حال ارسال یا در انتظار پاسخ نمانده باشد؛ با وضعیت هر ردیف و شناسه‌ی تنوع‌های ساخته‌شده.

هر پیام ممکن است تکراری یا با ترتیب جابه‌جا برسد؛ با شناسه‌ی رویداد تکراری‌ها را کنار بگذارید.

Authorizations

• apiKey

Parameters

Header Parameters

S360-Signature

required

string

امضای پیام: t=<زمان>,v1=<امضا> (و در دوره‌ی چرخش کلید، دو v1). امضا HMAC-SHA256 روی رشته‌ی «زمان + نقطه + بدنه‌ی خام» با کلید امضای نشانی است. امضا را روی بدنه‌ی خام و پیش از هر تبدیلی بررسی کنید، با مقایسه‌ی ثابت‌زمان، و هر یک از v1ها که درست بود کافی است. پیام با اختلاف زمانی بیش از ۵ دقیقه را رد کنید.

S360-Event-Id

required

string

شناسه‌ی رویداد؛ در همه‌ی تلاش‌های دوباره ثابت است. رویدادی را که قبلا پردازش کرده‌اید کنار بگذارید.

S360-Event-Type

required

string

نوع رویداد.

Request Body

Media typeapplication/json

object

id

required

یکتا و ثابت در همه‌ی تلاش‌های دوباره.

string

Example

evt_0000001a

type

required

string

Example

stock.changed

created_at

required

string format: date-time

panel_id

required

integer

Example

1

livemode

false برای رویدادهای پنل نمایشی؛ برای پنل واقعی همیشه true.

boolean

data

required

object

type

required

Allowed value: variant.request_completed

data

required

object

request

required

object

id

required

integer

Example

57

source

required

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

string

Allowed values: builder similar panel excel api

title

string

Example

رنگ‌های تازه‌ی PE5144

created_at

required

string format: date-time

finished_at

string | null format: date-time

counts

required

تعداد ردیف‌ها در هر وضعیت.

object

key

additional properties

integer

Example

{
  "waiting": 0,
  "sending": 0,
  "unknown": 0,
  "done": 4,
  "failed": 1,
  "skipped": 1,
  "cancelled": 0,
  "archived": 0
}

items

فقط در پاسخ یک درخواست و وب‌هوک.

Array<object>

object

id

required

integer

Example

1903

position

required

integer

Example

0

product_id

required

integer

Example

22961150

product_title

string

Example

محافظ ولتاژ پارت الکتریک مدل PE5144

label

آنچه این ردیف را از بقیه جدا می‌کند.

string

Example

آبی · گارانتی ۱۸ ماهه پارت الکتریک · ارسال دیجی‌کالا

status

required

waiting در صف؛ sending در حال ارسال؛ unknown ارسال شده و پاسخ دیجی‌کالا نرسیده (پیش از هر کار دیگری جست‌وجو می‌شود و هرگز «ناموفق» گزارش نمی‌شود)؛ done ساخته شد؛ failed ناموفق؛ skipped تکراری؛ cancelled لغو شد؛ archived ساخته و سپس بایگانی شد.

string

Allowed values: waiting sending unknown done failed skipped cancelled archived

variant_id

کد DKPC تنوع ساخته‌شده.

integer | null

Example

91200417

message

پیام فارسی نتیجه یا علت ناموفق بودن.

string | null

attempts

integer

Example

1

sent_at

string | null format: date-time

finished_at

string | null format: date-time

Responses

2XX

دریافت شد.