حذف محدودیت مکانی (Delete: Update Location Whitelist)
برای حذف محدودیت مکانی کد تخفیف استفاده میشود.
اطلاعات عمومی
- آدرس:
/api/v2/purchased-voucher/{id}/location-whitelist/{location_id} - متد:
DELETE - نوع محتوا:
application/json - احراز هویت: نیازمند token
احراز هویت
- این درخواست نیاز به یک Authorization token دارد که باید در هدر ارسال شود.
پارامترهای مسیر
| پارامتر | نوع داده | ضروری | توضیحات |
|---|---|---|---|
| id | integer | بله | شناسه کد تخفیف خریداریشده |
| location_id | integer | بله | شناسه موقعیت مکانی سفیدشده برای حذف |
نمونه درخواست
curl --location --request DELETE 'https://corporate.snapp.site/api/v2/purchased-voucher/5113/location-whitelist/123' \
--header 'Authorization: <your_authorization_token>'
پاسخ موفق
{
"data": "Deleted",
"message": "OK",
"status": 0
}
توضیحات فیلدهای پاسخ
| فیلد | نوع داده | توضیحات |
|---|---|---|
| data | string | پیام موفقیتآمیز (مثلاً "Deleted") |
| message | string | پیام کلی پاسخ (مثلاً "OK") |
| status | integer | کد وضعیت پاسخ (0 برای موفقیت) |
خطاها
| کد وضعیت | توضیحات |
|---|---|
400 | درخواست نامعتبر (ورودیهای اشتباه) |
401 | نیاز به احراز هویت |
403 | دسترسی غیرمجاز |
404 | کد تخفیف یا موقعیت مکانی موردنظر یافت نشد |
500 | خطای داخلی سرور |