操作
GET /附件/ {ID} /内容
总结 | 获取原始数据带指定id的附件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
URL | / API / V1 /附件/ {ID} /内容 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
详细描述 | 下载附件的内容。使用此方法可下载完成的输出文件(文本或字幕,取决于您所下的订单类型)或订单的源文件。 在关闭附件的所有编辑器会话至少两分钟后,此端点将检索附件的最新版本,包括编辑。 对于输出文件附件,您可以请求以特定的表示形式(文件格式)获取内容,要么通过Accept HTTP头,要么通过将扩展附加到URL的末尾。 如果您选择在订单中请求时间戳,您可以从您的成绩单中检索行内间隔时间戳(例如,每30秒)或每个单词时间戳。每个字的时间戳只适用于JSON格式,所有其他输出格式都使用间隔时间戳。 烧屏字幕视频附件(附件种类= burnedin)是特殊的。在接受头被忽略,他们被当做返回没有转换,始终与视频/ MP4内容类型。他们也没有包括任何客户的编辑(如果你愿意的话,你可能会产生烧屏与客户字幕编辑器内反映的客户编辑视频)。 下面的表示是支持人类的成绩单和自动化的成绩单:
{ “扬声器”:[{ “ID”:1, “名称”: “受访者”},{ “ID”:2 “名称”: “访”}],/ *独白(转录语音)。每个独白对应于文字从一个扬声器运行。* / “独白”:[{ “ID”:1, “扬声器”:1,/ *者ID,与上述相同* / “SPEAKER_NAME” 为宣称: “受访者”,/ *扬声器名称,与上述相同声明* // *独白的元素。每个元素都是文本(转录语音)或标签(注释),诸如听不到的或串扰。文本元素可能会或可能不会包含时间戳。标签元素需要一个时间戳。* /“元素”:[{/ *文本元素,没有时间戳* /“类型”:“文本”,/ *的文本元素,值包含文本* /“值”:“我从来没有来过这里已经”},{/ *标签元件* / “类型”: “标签”,/ *对于标记元素,值包含注释类型* / “值”: “无声”,/ *时间戳格式为HH:MM:SSS,FFF其中FFF表示毫秒* /“时间戳”:“00:00:07000”},/ *文本元素,每字时间戳空白和标点符号不时间戳* / {“类型”:“文本”,“值”: " " }, { "type": "text", "value": "so", "timestamp": "00:00:20,000", "end_timestamp": "00:00:20,138" }, { "type": "text", "value": " " }, { "type": "text", "value": "this", "timestamp": "00:00:20,222", "end_timestamp": "00:00:20,566" } ] } ] } 以下陈述都支持字幕:
如果不支持输出文件所要求的表示,那么406不可接受的状态代码将被退回。与Accept报头,则可以指定多个可接受的表示(如在所描述的接受头HTTP规范),以及最佳匹配将被退回。 如果您没有通过Accept头或URL扩展名指定所需的表示形式,那么输出文件内容将以默认格式返回。对于文本,这将是一个JSON输出。对于标题,这将是SubRip(.SRT)文件。 对于源媒体附件,我们目前不支持多个表示。他们总是在他们所上传的原始格式返回。如果指定Accept头或扩展不原始格式相匹配,一个406不可接受的状态代码将被退回。 对于文本,如果您以纯文本表示请求附件(使用“Accept: text/plain”头或“.txt”URL扩展名),还可以使用Accept- charset HTTP头请求特定字符编码。支持以下编码:
如果您没有通过Accept-Charset头指定所需的字符编码,那么将使用UTF-8编码。如果请求的不是纯文本表示,那么Accept-Charset头将被忽略。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
请求参数 |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
请求头 |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
响应 | 成功时,200 OK。 如果没有找到给定id的附件,404没有找到 如果附件中没有要求的陈述,406不可接受 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
响应头 |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
响应体 | 成功后,附件内容的原始数据按照要求的格式 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
错误代码 | 没有一个 |