API說明
API位置 |
/new_ezding/coupons/attach |
需求描述 |
優惠券歸戶 |
傳輸物件格式 |
json |
方法 |
POST |
範例
curl -X GET \
-H " X-Ftcsys-key: {KEY}" \
-H " X-Ftc-Authorization: {token}" \
-H " X- Accept-Language: {language}" \
-H "Content-Type: application/json" \
-d {
"coupon_number": "dsd30678"
}
http:
回傳範例
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
"result": "dsd30678",(<--優惠券序號)
"code": 200,
"status":"success"
}
HTTP回應碼 |
result |
說明 |
200 |
"" |
優惠券歸戶成功 |
403.313 |
"" |
優惠券歸戶失敗 |
404.007 |
"" |
優惠券不存在 |
403.107 |
"" |
參數錯誤、無效的token |
409.006 |
"" |
優惠券無法歸戶,該序號為其他帳號所擁有 |
401.103 |
"" |
使用者存取token無效 |
接收json參數
參數 |
名稱 |
範例 |
必填 |
備註 |
coupon_number |
優惠券序號 |
dsd30678 |
Y |
use_status 新舊DB 代碼mapping
舊DB f_status 代碼 |
新DB use_status 代碼 |
說明 |
0 |
0 |
已建立 |
1 |
0 |
可兌換 |
2 |
3 |
已兌換 |
3 |
4 |
凍結 |
4 |
1、2 |
轉贈中、已轉贈 |
無,看expired_time |
999 |
已過期 |