Yoho-Documents / API-Interfaces · Files

1、激活礼品卡

激活礼品卡（method=app.giftcard.activate）

公共请求参数

参数名称	参数类型	长度	可否为空	示例	默认值	备注
client_secret	string	50	否	5ac68f20cb18efe154be		进入接口提供的参数加密信息
app_version	float	10	否	1		APP版本
os_version	string	20	否	Android4.4		系统版本+机器型号
client_type	string	20	否	iphone/android/ipad		手机型号（不区分大小写）
screen_size	string	20	否	800x900		（手机尺寸）

请求参数

参数名称	参数类型	长度	可否为空	示例	默认值	备注
uid	String		否	50001678	empty string
cardCode	String		否	LPK00500000001	empty string	礼品卡卡号
cardPwd	String		否	040c98cda4084447a694f92fec907d79:2hbKUhE8RMzjIG8MhIBXPzSLryk7juLl	empty string	礼品卡卡密

注意，通用的头部没有列出。

请求示例（将debug=XYZ换为通用头） http://localhost:8090/gateway?method=app.giftcard.activate&uid=500027364&cardCode=LPK00500000001&cardPwd=040c98cda4084447a694f92fec907d79:2hbKUhE8RMzjIG8MhIBXPzSLryk7juLl

激活成功时，否则是失败。响应JSON格式如下所示:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": [],
    "md5": "f4a7a490bb6666b005008d795ed14e5d",
    "message": "操作成功"
}

不合法情况，响应JSON格式可能有如下几种情况:

{
    "message": "礼品卡卡号不能为空",
    "code": 403
}

{
    "message": "礼品卡卡密不能为空",
    "code": 402
}

{
    "message": "uid不能为空",
    "code": 403
}

{
    "message": "礼品卡卡号或卡密不正确",
    "code": 501
}

{
    "message": "礼品卡已激活，请勿重复激活",
    "code": 503
}

{
    "message": "礼品卡未开卡，请联系客服",
    "code": 502
}