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

使用说明

调用该接口可查询的共享播报数据的时间会延迟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
}