调用该接口分页查询千里传音中共享播报的小时数据。

使用说明

调用该接口可查询的共享播报数据的时间会延迟6小时。例如早上07:15分播报数据，需要延迟6个小时后，即在13:15后才能查询到07:15分播报的数据。

QPS限制

单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为100。

说明 RAM用户共享阿里云账号配额。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 PageQuerySpeechBroadcastHour

系统规定参数。取值：PageQuerySpeechBroadcastHour。
QueryDateTimeHour String 是 2020090919

要查询的时间。2020090919表示2020年09月09日19时。
ShareTaskCode String 是 ebed9280_ba25_48df_80c2_****

语料分享任务的分享码。

您可在千里传音语音播报服务的分享语料管理页面，获取分享码。

IotInstanceId String 否 iot-2w****

实例ID。您可在物联网平台控制台的实例概览页面，查看当前实例的ID。

注意
  • 若有ID值，必须传入该ID值，否则调用会失败。
  • 若无实例概览页面或ID值，则无需传入。

实例的更多信息，请参见实例概述。

PageSize Integer 否 10

指定返回结果中每页显示的记录数量，默认值为10，最大不超过2,000。
PageToken String 否 TGlzdFJlc291cm****

下一页标识，首次查询无需传入。后续查询需使用的PageToken，要从上一次查询的返回结果中获取。

例如查询第n页时，传入查询第n-1页返回的PageToken值。

调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。

返回数据

名称 类型 示例值 描述
Code String iot.system.SystemException

调用失败时，返回的错误码。更多信息，请参见错误码。

Data Struct

调用成功，返回的结果。
PageId Integer 1

当前页码。
PageSize Integer 10

每页显示数据条数。
PageToken String TGlzdFJlc291cm****

下一页标识。可在下次请求时传入，来获取下一页数据。

如果PageToken值为空，表示没有下一页数据。

ResultData Array of Data

返回的共享播报数据。
Data
Code Integer 0

播报结果码。返回值：

  • 0：语料播报成功。
  • 1：语料已播报，重复播报。
  • 2：语料不存在。
DeviceName String device1

设备名称。
Msg String 播报成功。

播报结果信息。
ProductKey String sd34****

设备所属产品的ProductKey。

ShareTaskCode String ebed9280_ba25_48df_80c2_****

共享码。
SpeechId String 42000011392021112380****

播报ID。
Speechs String ["ANC","CDF"]

播报语料。JSON数组格式。
StartTime Long 1663210172207

播报开始时间戳，单位为毫秒。
Total Integer 100

数据记录总数量。
ErrorMessage String 系统异常

调用失败时，返回的出错信息。
RequestId String E4C0FF92-2A86-41DB-92D3-73B60310D25E

阿里云为该请求生成的唯一标识符。
Success Boolean true

表示是否调用成功。

  • true：调用成功。
  • false：调用失败。

示例

请求示例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=PageQuerySpeechBroadcastHour
&QueryDateTimeHour=2020090919
&ShareTaskCode=1001
&<公共请求参数>

正常返回示例

XML格式 

<PageQuerySpeechBroadcastHourResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <Data>
        <PageId>1</PageId>
        <PageSize>10</PageSize>
        <Total>100</Total>
        <PageToken>TGlzdFJlc291cm****</PageToken>
        <ResultData>
              <Data>
                    <Msg>播报成功。</Msg>
                    <Speechs>["ANC","CDF"]</Speechs>
                    <ShareTaskCode>ebed9280_ba25_48df_80c2_****</ShareTaskCode>
                    <StartTime>1663210172207</StartTime>
                    <Code>0</Code>
                    <ProductKey>sd34****</ProductKey>
                    <SpeechId>42000011392021112380****</SpeechId>
                    <DeviceName>device1</DeviceName>
              </Data>
        </ResultData>
  </Data>
  <Success>true</Success>
</PageQuerySpeechBroadcastHourResponse>

JSON格式 

{
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "Data": {
        "PageId": 1,
        "PageSize": 10,
        "Total": 100,
        "PageToken": "TGlzdFJlc291cm****",
        "ResultData": {
            "Data": {
                "Msg": "播报成功。",
                "Speechs": "[\"ANC\",\"CDF\"]",
                "ShareTaskCode": "ebed9280_ba25_48df_80c2_****",
                "StartTime": 1663210172207,
                "Code": 0,
                "ProductKey": "sd34****",
                "SpeechId": "42000011392021112380****",
                "DeviceName": "device1"
            }
        }
    },
    "Success": true
}