بای‌باکس یک تنوع به دست آمد

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: buybox.won

data

required

object

buybox

required

object

variant_id

required

integer

Example

84780448

sku

string | null

status

required

• winner: بای‌باکس در اختیار شماست.
• winnable: قیمت تخمینی بردن بالاتر یا برابر حداقل قیمت شماست؛ ربات تا آن پایین می‌آید.
• structural: حتی قیمت تخمینی بردن زیر حداقل قیمت شماست و ربات بدون کاهش حداقل نمی‌تواند ببرد.

string

Allowed values: winner winnable structural

winner

required

بای‌باکس در اختیار شماست.

boolean

box_scope

برای برنده‌ها، بای‌باکس کل کالا (product) یا فقط همین تنوع و رنگ (variant).

string | null

Allowed values: product variant

live

required

خواندن ربات تازه است (حداکثر ۶ ساعت)؛ در غیر این صورت برنده بودن از همگام‌سازی روزانه‌ی پنل است.

boolean

reading_age_hours

سن خواندن ربات به ساعت، با یک رقم اعشار.

number | null

Example

0.2

position

جایگاه شما در فهرست فروشندگان (۱ یعنی برنده).

integer | null

Example

2

rival_count

تعداد رقبا در این بای‌باکس.

integer | null

Example

4

our_price

قیمت شما در صفحه‌ی عمومی دیجی‌کالا به ریال.

integer | null

Example

302000000

rival_price

قیمت واقعی صاحب فعلی بای‌باکس به ریال.

integer | null

Example

298500000

rival_is_fbd

کالای صاحب بای‌باکس در انبار دیجی‌کالاست.

boolean

holder

صاحب بای‌باکس در آخرین مشاهده.

object

name

string

Example

فروشگاه نمونه

seller_id

integer | null

Example

1083422

is_you

boolean

is_own_panel

یکی از پنل‌های دیگر حساب شماست، نه رقیب.

boolean

win_price

قیمت تخمینی لازم برای بردن (بالای دامنه‌ی کاهش ربات، نه قول قطعی).

One of:

object

مبلغی که سلر ۳۶۰ تخمین زده است، نه عددی که دیجی‌کالا اعلام کرده باشد.

object

value

required

ریال.

integer

Example

268000000

estimated

required

boolean

null

null

drop_to_win

کاهش لازم از قیمت فعلی تا قیمت بردن به ریال (فقط برای غیربرنده با خواندن تازه).

integer | null

headroom

فضای افزایش قیمت بدون از دست دادن بای‌باکس به ریال (فقط برای برنده با خواندن تازه).

integer | null

floor

حداقل قیمتی که ربات رعایت می‌کند.

integer | null

Example

280000000

floor_source

One of:

string

حداقلی که ربات اکنون رعایت می‌کند از کجا آمده است:

• manual: حداقل قیمت دستی.
• cost_plus: بهای خرید به‌علاوه‌ی سود هدف.
• strategy: حداقل قیمتی که استراتژی (مثلا بر پایه‌ی حاشیه‌ی سود یا قیمت مرجع) می‌سازد.

string

Allowed values: manual cost_plus strategy

null

null

floor_gap

فاصله‌ی حداقل قیمت تا قیمت بردن به ریال، وقتی حداقل بالاتر است.

integer | null

floor_gap_pct

همان فاصله به درصد حداقل قیمت.

number | null

floor_blocks

تنها حداقل قیمت شما مانع بردن است و بردن با قیمت بردن هنوز زیان‌ده نیست.

boolean

breakeven

کمترین قیمت با سود خالص صفر.

One of:

object

مبلغی که سلر ۳۶۰ تخمین زده است، نه عددی که دیجی‌کالا اعلام کرده باشد.

object

value

required

ریال.

integer

Example

268000000

estimated

required

boolean

null

null

profit_pct

سود خالص فعلی به درصد قیمت، با یک رقم اعشار.

number | null

Example

8.4

win_profit_pct

سود خالص در قیمت بردن به درصد.

number | null

synced_at

required

زمان آخرین خواندن ربات.

string | null format: date-time

Responses

2XX

دریافت شد.