تاریخچه کد تخفیف چندگانه (Get: Bulk Voucher History)
تاریخچه کدهای تخفیف مربوط به چند سفر را نمایش می‌دهد.
اطلاعات عمومی
- آدرس:
/api/v2/purchased-voucher/{id}/history/bulk - متد:
GET - نوع محتوا:
application/json - احراز هویت: نیازمند token
احراز هویت
- این درخواست نیاز به یک Authorization token دارد که باید در هدر ارسال شود.
پ ارامترهای مسیر
| پارامتر | نوع داده | ضروری | توضیحات |
|---|---|---|---|
| id | integer | بله | شناسه کد تخفیف خریداری‌شده |
نمونه درخواست
curl --location --request GET 'https://corporate.snapp.site/api/v2/purchased-voucher/5113/history/bulk' \
--header 'Authorization: <your_authorization_token>'
پاسخ موفق
{
"data": [
{
"voucher_code": "SNAPP123",
"title": "تخفیف ویژه",
"used_at": "2023-10-27T10:00:00Z"
},
{
"voucher_code": "SNAPP456",
"title": "تخفیف سازمانی",
"used_at": "2023-10-28T12:30:00Z"
}
],
"message": "OK",
"status": 0
}
توضیحات فیلدهای پاسخ
لیست اطلاعات کد تخفیف (data)
| فیلد | نوع داده | توضیحات |
|---|---|---|
| voucher_code | string | کد تخفیف |
| title | string | عنوان کد تخفیف (اختیاری) |
| used_at | string | تاریخ و زمان استفاده از کد تخفیف (اختیاری) |
اطلاعات کلی پاسخ
| فیلد | نوع داده | توضیحات |
|---|---|---|
| message | string | پیام کلی پاسخ (مثلاً "OK") |
| status | integer | کد وضع یت پاسخ (0 برای موفقیت) |
خطاها
| کد وضعیت | توضیحات |
|---|---|
400 | درخواست نامعتبر (ورودی‌های اشتباه) |
401 | نیاز به احراز هویت |
403 | دسترسی غیرمجاز |
404 | کد تخفیف موردنظر یافت نشد |
500 | خطای داخلی سرور |