订单查询

DeepL订单一般耗时5-30秒，具体取决于字幕内容大小。一般创建订单后，可以通过查询接口（/query）轮询结果，建议每次轮询间隔2-3秒。
也可以在创建订单时设置异步通知链接（notify_url），这样订单后，系统会主动通知订单结果信息到设定的链接。

异步通知

订单处理成功：

字段名	类型	示例
code	integer	1
msg	string	订单处理成功
status	integer	1
file_url	string	https://www.zimufy.com/translate_api/file_down?order_id=zm78377fe0f025t
file_size	string	84 KB
cost_time	integer	251

订单处理失败：

字段名	类型	示例
code	integer	1
msg	string	订单处理失败
status	integer	4

系统以json头部与json内容形式发送POST通知，下面是主流语言接收通知的代码示例，确保最后返回HTTP200状态码即可，如果遇到网络异常或者返回状态码不是200，系统会再重试2次进行通知。

python接收示例

php接收示例

JavaScript接收示例

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/notify', methods=['POST'])
def handle_notify():
  data = request.json  # 自动解析JSON数据
  print("收到通知数据:", data)
  
  # 这里处理业务逻辑，比如验证数据、更新订单状态等
  
  # 返回成功响应 (HTTP 200)
  return 'success'

if __name__ == '__main__':
  app.run(port=5000)

application/json

Body

code

enum<integer>

校验码

必需

0-参数校验失败 1-参数校验成功

枚举值:

msg

string

信息提示

必需

status

enum<integer>

订单状态

可选

0-进行中 1-已完成 4-失败

枚举值:

014

file_url

string

下载地址

可选

file_size

string

文件大小

可选

cost_time

integer

订单耗时（秒）

可选

示例

订单进行中订单处理成功订单处理失败参数校验失败

{
  "code": 1,
  "msg": "订单进行中",
  "status": 0
}

请求参数

示例代码

返回响应