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 |
已過期 |