智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
创建礼品卡模板
本文导读
功能介绍
添加礼品卡模板到钱包服务器。
场景描述
开发者可以调用该API，将某一种类的礼品卡模板添加到钱包服务器。
使用约束
需在华为AGC网站上创建应用并申请卡券对应的服务。
接口原型
承载协议 | HTTPS POST |
|---|---|
接口方向 | 开发者服务器->华为钱包服务器 |
接口URL | {url}/hmspass/v1/giftcard/model {url}变量需要开发者根据服务器所属区域自行选择，请参见钱包服务器地址。 |
数据格式 | 请求消息：Content-Type: application/json 响应消息：Content-Type: application/json |
请求参数
Request Header：
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Authorization | 是 | String | 鉴权码。获取方式详见基于OAuth 2.0开放鉴权，请使用“客户端模式”。“client_id”和“client_secret”即为开发者在华为AGC网站上创建应用后获取的“App ID”和“App key”。将获取到的“access_token”的值拼接在字符串“Bearer”之后，以空格符相隔，组成“Authorization”参数的值。 |
Content-Type | 是 | String | 固定值：“application/json;charset=utf-8”。 |
Accept | 是 | String | 固定值：“application/json;charset=utf-8”。 |
Request Body：
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
详见HwWalletObject参数描述 | 是 | 待添加的卡券模板 |
请求示例
POST /hmspass/v1/giftcard/model HTTP/1.1
Content-Type: application/json;charset=utf-8
Authorization: Bearer ***
Host: wallet-passentrust-drcn.cloud.huawei.com.cn
Accept: application/json;charset=utf-8
{
"passVersion": "1.0",
"passTypeIdentifier": "hwpass.com.huawei.wallet.giftcard.test",
"passStyleIdentifier": "giftCardModelTest",
"organizationName": "Huawei",
"fields": {
"countryCode": "CN",
"locationList": [
{
"longitude": "114.0679603815",
"latitude": "22.6592051284"
}
],
"commonFields": [
{
"key": "logo",
"value": "https://www.huawei.com/XXX.png"
},
{
"key": "backgroundImage",
"value": "https://www.huawei.com/XXX.png"
},
{
"key": "name",
"value": "Gift Card"
},
{
"key": "merchantName",
"value": "XXX Super Market",
"localizedValue": "merchantNameI18N"
},
{
"key": "eventNumber",
"value": "223421515222143",
"label": "Event Number",
"localizedValue": "eventNameI18n"
}
],
"appendFields": [
{
"key": "backgroundColor",
"value": "#483d8b"
},
{
"key": "hotline",
"value": "8006011450"
},
{
"key": "website",
"value": "https://www.huawei.com"
}
],
"messageList": [
{
"key": "message[0]",
"value": "Welcome to use this gift card.",
"label": "Welcome"
},
{
"key": "message[1]",
"value": "This gift card is used for XXX.",
"label": "Explanation"
}
],
"imageList": [
{
"key": "mainImage[0]",
"value": "https://www.huawei.com/XXX0.png"
},
{
"key": "mainImage[1]",
"value": "https://www.huawei.com/XXX1.png"
},
{
"key": "mainImage[2]",
"value": "https://www.huawei.com/XXX2.png"
}
],
"localized": [
{
"key": "merchantNameI18N",
"language": "zh-cn",
"value": "某某超市"
},
{
"key": "merchantNameI18N",
"language": "en",
"value": "XXX Super Market"
},
{
"key": "eventNumberI18N",
"language": "zh-cn",
"value": "活动编号"
},
{
"key": "eventNumberI18N",
"language": "en",
"value": "Event Number"
}
]
}
} 响应示例
HTTP/1.1 200 OK
Content-Type: application/json
{
"passVersion": "1.0",
"passTypeIdentifier": "hwpass.com.huawei.wallet.giftcard.test",
"passStyleIdentifier": "giftCardModelTest",
"organizationName": "Huawei",
"fields": {
"countryCode": "CN",
"locationList": [
{
"longitude": "114.0679603815",
"latitude": "22.6592051284"
}
],
"commonFields": [
{
"key": "logo",
"value": "https://www.huawei.com/XXX.png"
},
{
"key": "backgroundImage",
"value": "https://www.huawei.com/XXX.png"
},
{
"key": "name",
"value": "Gift Card"
},
{
"key": "merchantName",
"value": "XXX Super Market",
"localizedValue": "merchantNameI18N"
},
{
"key": "eventNumber",
"value": "223421515222143",
"label": "Event Number",
"localizedValue": "eventNameI18n"
}
],
"appendFields": [
{
"key": "backgroundColor",
"value": "#483d8b"
},
{
"key": "hotline",
"value": "8006011450"
},
{
"key": "website",
"value": "https://www.huawei.com"
}
],
"messageList": [
{
"key": "message[0]",
"value": "Welcome to use this gift card.",
"label": "Welcome"
},
{
"key": "message[1]",
"value": "This gift card is used for XXX.",
"label": "Explanation"
}
],
"imageList": [
{
"key": "mainImage[0]",
"value": "https://www.huawei.com/XXX0.png"
},
{
"key": "mainImage[1]",
"value": "https://www.huawei.com/XXX1.png"
},
{
"key": "mainImage[2]",
"value": "https://www.huawei.com/XXX2.png"
}
],
"localized": [
{
"key": "merchantNameI18N",
"language": "zh-cn",
"value": "某某超市"
},
{
"key": "merchantNameI18N",
"language": "en",
"value": "XXX Super Market"
},
{
"key": "eventNumberI18N",
"language": "zh-cn",
"value": "活动编号"
},
{
"key": "eventNumberI18N",
"language": "en",
"value": "Event Number"
}
]
}
} 错误码
详见错误码。
调用示例
public HwWalletObject postHwWalletObjectToWalletServer(String url, HwWalletObject hwWalletObject) {
// Construct the http header.
HttpHeaders header = constructHttpHeaders();
// Construct the http body.
String body = CommonUtil.toJson(hwWalletObject);
JSONObject jsonObj = JSONObject.parseObject(body);
System.out.println("Request JSON : " + jsonObj);
// Construct the http URL.
String baseUrl = ConfigHelper.instants().getValue("walletServerBaseUrl");
String walletServerUrl = baseUrl + url;
// Send the http request and get response.
HttpEntity<JSONObject> entity = new HttpEntity<>(jsonObj, header);
ResponseEntity<HwWalletObject> exchange =
REST_TEMPLATE.exchange(walletServerUrl, HttpMethod.POST, entity, HwWalletObject.class);
// Return the posted wallet model.
return exchange.getBody();
} 在 API参考 中进行搜索
请输入您想要搜索的关键词