承载协议	HTTPS POST
接口方向	开发者服务器->华为钱包服务器
接口URL	{url}/hmspass/v1/transit/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参数描述	是	HwWalletObject	待添加的卡券模板

请求示例

收起
自动换行
深色代码主题
复制
POST /hmspass/v1/transit/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.transit.test",
  "passStyleIdentifier": "transitModelTest",
  "organizationName": "XXX Railway",
  "fields": {
    "countryCode": "CN",
    "locationList": [
      {
        "longitude": "114.0679603815",
        "latitude": "22.6592051284"
      }
    ],
    "commonFields": [
      {
        "key": "logo",
        "value": "https://www.huawei.com/XXX.png"
      },
      {
        "key": "merchantName",
        "value": "XXX Railway",
        "localizedValue": "merchantNameI18N"
      }
    ],
    "appendFields": [
      {
        "key": "backgroundColor",
        "value": "#FF37C09A"
      },
      {
        "key": "ticketFaceValue",
        "value": "$127"
      }
    ],
    "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"
      }
    ],
    "messageList": [
      {
        "key": "message[0]",
        "value": "Have a nice trip!"
      }
    ],
    "ticketInfoList": [
      {
        "key": "departureStationName",
        "value": "Euston"
      },
      {
        "key": "arrivalStationName",
        "value": "Lime Street"
      },
      {
        "key": "departureCityName",
        "value": "London"
      },
      {
        "key": "arrivalCityName",
        "value": "Liverpool"
      },
      {
        "key": "departureTime",
        "value": "2019-12-09T10:49:00.010Z"
      },
      {
        "key": "arrivalTime",
        "value": "2019-12-09T13:55:00.010Z"
      },
      {
        "key": "platform",
        "value": "2"
      }
    ],
    "localized": [
      {
        "key": "merchantNameI18N",
        "language": "zh-cn",
        "value": "XXX铁路公司"
      },
      {
        "key": "merchantNameI18N",
        "language": "en",
        "value": "XXX Railway"
      }
    ]
  }
}

响应参数

错误码为200时：

展开

参数	参数类型	描述
详见HwWalletObject参数描述	HwWalletObject	已添加的卡券模板

响应示例

收起
自动换行
深色代码主题
复制
HTTP/1.1 200 OK
Content-Type: application/json
{
  "passVersion": "1.0",
  "passTypeIdentifier": "hwpass.com.huawei.wallet.transit.test",
  "passStyleIdentifier": "transitModelTest",
  "organizationName": "XXX Railway",
  "fields": {
    "countryCode": "CN",
    "locationList": [
      {
        "longitude": "114.0679603815",
        "latitude": "22.6592051284"
      }
    ],
    "commonFields": [
      {
        "key": "logo",
        "value": "https://www.huawei.com/XXX.png"
      },
      {
        "key": "merchantName",
        "value": "XXX Railway",
        "localizedValue": "merchantNameI18N"
      }
    ],
    "appendFields": [
      {
        "key": "backgroundColor",
        "value": "#FF37C09A"
      },
      {
        "key": "ticketFaceValue",
        "value": "$127"
      }
    ],
    "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"
      }
    ],
    "messageList": [
      {
        "key": "message[0]",
        "value": "Have a nice trip!"
      }
    ],
    "ticketInfoList": [
      {
        "key": "departureStationName",
        "value": "Euston"
      },
      {
        "key": "arrivalStationName",
        "value": "Lime Street"
      },
      {
        "key": "departureCityName",
        "value": "London"
      },
      {
        "key": "arrivalCityName",
        "value": "Liverpool"
      },
      {
        "key": "departureTime",
        "value": "2019-12-09T10:49:00.010Z"
      },
      {
        "key": "arrivalTime",
        "value": "2019-12-09T13:55:00.010Z"
      },
      {
        "key": "platform",
        "value": "2"
      }
    ],
    "localized": [
      {
        "key": "merchantNameI18N",
        "language": "zh-cn",
        "value": "XXX铁路公司"
      },
      {
        "key": "merchantNameI18N",
        "language": "en",
        "value": "XXX Railway"
      }
    ]
  }
}

错误码

详见错误码。

调用示例

收起
自动换行
深色代码主题
复制
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();
}

优惠券个人化实例增加message

单个查询交通卡模板

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问