承载协议	HTTPS GET
接口方向	开发者服务器->华为钱包服务器
接口URL	{url}/hmspass/v1/eventticket/model?session={session}&pageSize={pageSize} {url}变量需要开发者根据服务器所属区域自行选择，请参见钱包服务器地址。
数据格式	请求消息：Content-Type: application/json 响应消息：Content-Type: application/json

查询参数

展开

参数	是否必选	参数类型	描述
pageSize	否	int	每次返回的记录数。最大值为50。如果pageSize未定义，则返回所有结果。
session	否	String	如果指定了pageSize且对象总数大于pageSize，调用批量查询接口会返回一个nextSession参数。再次调用此接口时，将这个session参数设置为之前获取的nextSession，可以得到下一组对象。调用批量查询接口获取第一组对象时不填写此参数。

备注：pageSize和session都不存在则返回全部对象。pageSize存在而session不存在，则返回第一组对象。pageSize和session都存在则返回下一组对象。不能填写了session而不填写pageSize。对象总数超过50时必须设置pageSize。使用session查询下一组对象时，pageSize应与之前使用的值保持一致。

请求参数

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”。

请求示例

收起
自动换行
深色代码主题
复制
GET /hmspass/v1/eventticket/model HTTP/1.1
Content-Type: application/json;charset=utf-8
Authorization: Bearer ***
Accept: application/json;charset=utf-8
Host: wallet-passentrust-drcn.cloud.huawei.com.cn

响应参数

错误码为200时：

展开

参数	参数类型	描述
data	List<HwWalletObject>	卡券模板列表
pageInfo	PageInfo	页面信息

PageInfo：

展开

参数	参数类型	描述
pageSize	int	返回列表的长度
nextSession	String	查询下一页使用的session，5分钟内有效。

响应示例

收起
自动换行
深色代码主题
复制
HTTP/1.1 200 OK
Content-Type: application/json
{
  "data": [
    {
      "passVersion": "1.0",
      "passTypeIdentifier": "hwpass.com.huawei.wallet.eventticket.test",
      "passStyleIdentifier": "eventTicketModelTest",
      "organizationName": "Huawei",
      "fields": {
        "countryCode": "CN",
        "locationList": [
          {
            "longitude": "114.0679603815",
            "latitude": "22.6592051284"
          }
        ],
        "commonFields": [
          {
            "key": "logo",
            "value": "https://www.huawei.com/XXX.png"
          },
          {
            "key": "name",
            "value": "XXX Party Ticket"
          },      
          {
            "key": "merchantName",
            "value": "Huawei",
            "localizedValue": "merchantNameI18N"
          },
          {
            "key": "address",
            "value": "XXX location"
          },
          {
            "key": "ticketType",
            "value": "Adult ticket"
          }
        ],
        "appendFields": [
          {
            "key": "backgroundColor",
            "value": "#FF1C2635"
          }
        ],
        "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": "Welcome to the party!"
          }
        ],
        "timeList": [
          {
            "key": "startTime",
            "value": "2020-01-22T09:20:00.083Z"
          },
          {
            "key": "endTime",
            "value": "2020-01-22T12:20:00.083Z"
          }
        ],
        "localized": [
          {
            "key": "merchantNameI18N",
            "language": "zh-cn",
            "value": "华为"
          },
          {
            "key": "merchantNameI18N",
            "language": "en",
            "value": "Huawei"
          }
        ]
      }
    }
  ],
  "pageInfo": {
    "pageSize": 1,
    "nextSession":"sesstionValue"
  }
}

错误码

详见错误码。

调用示例

收起
自动换行
深色代码主题
复制
public List<HwWalletObject> listWalletModel(String url, Integer pageSize) {
    // Construct the http header.
    HttpHeaders header = constructHttpHeaders();
    // Construct the http URL.
    String baseUrl = ConfigHelper.instants().getValue("walletServerBaseUrl");
    String walletServerUrl = baseUrl + url;

    HttpEntity entity = new HttpEntity(header);
    if (pageSize == null) {
        ResponseEntity<BatchGetHwWalletResult> response =
            REST_TEMPLATE.exchange(walletServerUrl, HttpMethod.GET, entity, BatchGetHwWalletResult.class);
        BatchGetHwWalletResult batchGetHwWalletResult = response.getBody();
        if (batchGetHwWalletResult == null) {
            System.out.println("listWalletModel failed. batchGetHwWalletResult is null.");
            return null;
        } else {
            return batchGetHwWalletResult.getData();
        }
    } else {
        List<HwWalletObject> walletModelList = new LinkedList<>();
        String tempUrl = walletServerUrl + "?pageSize=" + pageSize;
        String session = "";
        while (true) {
            String finalUrl = tempUrl;
            if (!session.isEmpty()) {
                finalUrl = finalUrl + "&session=" + session;
            }
            ResponseEntity<BatchGetHwWalletResult> response =
                REST_TEMPLATE.exchange(finalUrl, HttpMethod.GET, entity, BatchGetHwWalletResult.class);
            BatchGetHwWalletResult batchGetHwWalletResult = response.getBody();
            if (batchGetHwWalletResult == null) {
                System.out.println("listWalletModel failed. batchGetHwWalletResult is null.");
                return null;
            }
            List<HwWalletObject> data = batchGetHwWalletResult.getData();
            if (data == null || data.isEmpty()) {
                return walletModelList;
            }
            walletModelList.addAll(data);
            PageInfo pageInfo = batchGetHwWalletResult.getPageInfo();
            if (pageInfo == null) {
                System.out.println("listWalletModel failed. pageInfo is null.");
                return null;
            }
            String nextSession = pageInfo.getNextSession();
            if (nextSession == null || nextSession.isEmpty()) {
                return walletModelList;
            }
            session = nextSession;
        }
    }
}

单个查询活动门票模板

全量更新活动门票模板

意见反馈

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

意见反馈

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

社区提问 AI 助手提问