报告查询 | 优谷雅言 SDK 文档

请求示例

Shell

# 报告查询。被签名参数为空集合，recordId 是路径的一段
RECORD_ID=eval_a31712f40cbf
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
SIGN=$(printf '' | openssl dgst -sha256 -hmac "$YUGU_SECRET_KEY" -binary | base64)

curl -sS "https://open.shengzhiai.com/api/v1/report/$RECORD_ID" \
  -H "X-App-Key: $YUGU_APP_KEY" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGN"

Java

ReportResult report = client.getReport(args[0]);
JsonNode data = report.getData();
System.out.println("总分 " + data.path("score").path("overall").asDouble());
System.out.println("点评 " + data.path("report").path("summary").asText());

JavaScript

const report = await client.getReport(process.argv[2]);
console.log('点评', report.report?.summary, '维度分', report.report?.dimensionScores);

返回示例

200，节选

{
  "code": 0,
  "message": "success",
  "data": {
    "recordId": "eval_a31712f40cbf",
    "score": {
      "overall": 88.9,
      "pronunciation": 100,
      "fluency": 96,
      "integrity": 100,
      "tone": 83,
      "rhythm": 78,
      "speed": 225,
      "rear_tone": "fall",
      "duration": "1.920",
      "warning": []
    },
    "report": {
      "summary": "朗读整体表现优秀，语音清晰流畅，情感自然贴合文本。",
      "suggestions": [
        "读到『很』时注意第三声的降升调型。",
        "在『今天』后稍作停顿以增强节奏感。",
        "强调『很好』时加重语气突出情感。",
        "用更明亮的语调传递天气好的愉悦感。"
      ],
      "dimensionScores": {
        "accuracy": 100,
        "fluency": 96,
        "integrity": 100,
        "reading_skill": 78,
        "affect": 76,
        "speechRate": 85,
        "readSpeedRaw": 225
      },
      "rubricVersion": "v20260707b"
    }
  },
  "timestamp": 1791484346331
}

GET /api/v1/report/{recordId}，响应 {"code": 0, "data": {...}}，只能查询本账号的记录。

路径参数#

recordIdstring必填

评测返回的记录号，例如 eval_3fb45f4c8e71

被签名参数为空集合，recordId 是路径的一段，不参与签名。

返回#

data.recordIdstring必填

记录号

data.scoreobject必填

评测分数，字段与评测结果的 result 一致，总分为 data.score.overall

data.report.summarystring可选

整体点评

data.report.suggestionsarray可选

改进建议

data.report.dimensionScoresobject可选

维度分，键随语种与题型不同，值为 null 表示本次不评该维

报告查询天然幂等，可以重试，不需要幂等键。

状态码#

状态	错误码	原因
200	无	返回报告
400	40001	记录不存在
401	40100，2001 到 2011	未认证，签名错误，token 或 API Key 无效