وب‌هوک تغییر اطلاعات استیشن

تامین‌کننده‌ها می‌توانند برای اطلاع از برخی تغییرات استیشن‌هایی که به آن‌ها اختصاص داده شده است، یک آدرس وب‌هوک داشته باشند. این آدرس در صورت نیاز توسط پشتیبانی فنی تنظیم می‌شود.

وب‌هوک برای تغییرات زیر پشتیبانی می‌شود:

• تغییر موقعیت جغرافیایی استیشن:
  • latitude
  • longitude
• تغییر آدرس استیشن:
  • address
• تغییر کدپستی استیشن:
  • postal_code
• تغییر نام استیشن:
  • nickname
• تغییر برنامه‌ی هفتگی استیشن:
  • weekly_schedule
• تغییر اسلاگ استیشن:
  • slug
• تغییر ظرفیت استیشن برای تامین‌کننده:
  • capacity
• ایجاد downtime برای استیشن (برای مرخصی یا تعطیلات رسمی):
  • downtime

ساختار مشترک وب‌هوک

تمام وب‌هوک‌های تغییر اطلاعات استیشن با ساختار event-based زیر ارسال می‌شوند:

{
  "event": "station_info_updated",
  "station": {
    "uuid": "station uuid",
    "slug": "station slug",
    "digikala_dc": {
      "dc_id": 123,
      "hashed_dc_id": "hashed id",
      "distribution_center_reference_id": 456
    }
  },
  "changes": {}
}

توضیح فیلدها:

• event: نوع رویداد که برای این وب‌هوک همیشه station_info_updated است.
• station: اطلاعات پایه‌ی استیشن
  • uuid: شناسه‌ی یکتای استیشن
  • slug: اسلاگ استیشن
  • digikala_dc: اطلاعات مرکز توزیع دیجیکالا
• changes: فیلدهایی که در این رویداد تغییر کرده‌اند.
  • هر تغییر با ساختار { "value": ... } ارسال می‌شود.

نمونه‌های payload

تغییر یک فیلد

{
  "event": "station_info_updated",
  "station": {
    "uuid": "7c9f5e56-4df8-4b65-9a32-4e5f6b7c8d90",
    "slug": "12345678",
    "digikala_dc": {
      "dc_id": 12,
      "hashed_dc_id": "abc123",
      "distribution_center_reference_id": 987654321
    }
  },
  "changes": {
    "address": {
      "value": "New station address"
    }
  }
}

تغییر چند فیلد

{
  "event": "station_info_updated",
  "station": {
    "uuid": "7c9f5e56-4df8-4b65-9a32-4e5f6b7c8d90",
    "slug": "12345678",
    "digikala_dc": null
  },
  "changes": {
    "latitude": {
      "value": 35.7219
    },
    "longitude": {
      "value": 51.3347
    },
    "nickname": {
      "value": "New station nickname"
    }
  }
}

تغییر برنامه‌ی هفتگی

{
  "event": "station_info_updated",
  "station": {
    "uuid": "7c9f5e56-4df8-4b65-9a32-4e5f6b7c8d90",
    "slug": "12345678",
    "digikala_dc": null
  },
  "changes": {
    "weekly_schedule": {
      "value": {
        "saturday": [
          {
            "start_time": "10:00:00",
            "duration": "0 12:00:00"
          }
        ],
        "sunday": [
          {
            "start_time": "10:00:00",
            "duration": "0 12:00:00"
          }
        ],
        "monday": [
          {
            "start_time": "10:00:00",
            "duration": "0 12:00:00"
          }
        ],
        "tuesday": [
          {
            "start_time": "10:00:00",
            "duration": "0 12:00:00"
          }
        ],
        "wednesday": [
          {
            "start_time": "10:00:00",
            "duration": "0 12:00:00"
          }
        ],
        "thursday": [
          {
            "start_time": "10:00:00",
            "duration": "0 12:00:00"
          }
        ],
        "friday": [
          {
            "start_time": "10:00:00",
            "duration": "0 12:00:00"
          }
        ]
      }
    }
  }
}

تغییر ظرفیت استیشن برای تامین‌کننده

{
  "event": "station_info_updated",
  "station": {
    "uuid": "7c9f5e56-4df8-4b65-9a32-4e5f6b7c8d90",
    "slug": "12345678",
    "digikala_dc": {
      "dc_id": 12,
      "hashed_dc_id": "abc123",
      "distribution_center_reference_id": 987654321
    }
  },
  "changes": {
    "capacity": {
      "value": 15
    }
  }
}

ایجاد downtime

{
  "event": "station_info_updated",
  "station": {
    "uuid": "7c9f5e56-4df8-4b65-9a32-4e5f6b7c8d90",
    "slug": "12345678",
    "digikala_dc": null
  },
  "changes": {
    "downtime": {
      "value": {
        "start_date": "2026-08-03T00:00:00+03:30",
        "end_date": "2026-08-04T00:00:00+03:30"
      }
    }
  }
}

نکات و محدودیت‌ها

اطلاع

• وب‌هوک مقدار قبلی فیلدها را ارسال نمی‌کند.
• در هر وب‌هوک فقط فیلدهایی که تغییر کرده‌اند در changes قرار می‌گیرند.