Skip to content

Changes

Page history
Update 英语作文批改接入文档 authored by zhaojiaojiao's avatar zhaojiaojiao
Show whitespace changes
Inline Side-by-side
英语作文批改接入文档.md
View page @ 493958fd
<p><strong>作文批改接口地址：<a href="http://aes.ssapi.cn/index.php?
action=essayEvalute">http://aes.ssapi.cn/index.php?action=essayEvalute</a> </strong></p><p><strong>替代商户权限系统地址：<a href="http://warrant.ssapi.cn">http://warrant.ssapi.cn</a></strong></p><h6>一、获取 appid 和 app\_secret</h6><p>商务沟通，提供邮箱获取先声教育的商户授权 appid 和 app\_secret。</p><h6>二、服务端搭建《商户授权服务》</h6><ol><li>git clone <a href="mailto:git@pt.singsound.com:singsound-platform/warrant-client-php.git">git@pt.singsound.com:singsound-platform/warrant-client-php.git</a></li><li>cd warrant-client-php &amp;&amp; mv .env.dist .env</li><li>composer install</li><li>vim .env</li></ol><p><img class="confluence-embedded-image" src="/download/attachments/9044773/image2018-4-2%2013%3A20%3A37.png?version=1&amp;modificationDate=1522646382832&amp;api=v2" data-image-src="/download/attachments/9044773/image2018-4-2%2013%3A20%3A37.png?version=1&amp;modificationDate=1522646382832&amp;api=v2" data-unresolved-comment-count="0" data-linked-resource-id="9044809" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="image2018-4-2 13:20:37.png" data-base-url="http://cf.singsound.com" data-linked-resource-content-type="image/png" data-linked-resource-container-id="9044773" data-linked-resource-container-version="14" title="语音平台文档 > 先声作文批改接入流程 > image2018-4-2 13:20:37.png" data-location="语音平台文档 > 先声作文批改接入流程 > image2018-4-2 13:20:37.png" data-image-height="99" data-image-width="523"></p><p> 5. vim index.php</p><p><img class="confluence-embedded-image" src="/download/attachments/9044773/image2018-3-30%2010%3A57%3A1.png?version=1&amp;modificationDate=1522378568053&amp;api=v2" data-image-src="/download/attachments/9044773/image2018-3-30%2010%3A57%3A1.png?version=1&amp;modificationDate=1522378568053&amp;api=v2" data-unresolved-comment-count="0" data-linked-resource-id="9044783" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="image2018-3-30 10:57:1.png" data-base-url="http://cf.singsound.com" data-linked-resource-content-type="image/png" data-linked-resource-container-id="9044773" data-linked-resource-container-version="14" title="语音平台文档 > 先声作文批改接入流程 > image2018-3-30 10:57:1.png" data-location="语音平台文档 > 先声作文批改接入流程 > image2018-3-30 10:57:1.png" data-image-height="246" data-image-width="558"></p><h6>三、发起作文批改请求</h6><ul><li>访问服务端的《商户授权服务》获取 warrant 参数。</li></ul><p>详见：四、<a>商户授权服务接口规范</a></p><ul><li>使用 warrant 参数以及《先声作文批改》接口参数，发起作文批改请求</li></ul><p>详见：<a>五、作文批改接口规范</a></p><h6>四、商户授权服务接口规范</h6><ul><li>请求参数说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p align="left">user\_id</p></td><td class="confluenceTd"><p align="left">string</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">''</p></td><td class="confluenceTd"><p align="left">商户自身的user\_id，用于warrant区分不同用户</p></td></tr><tr><td class="confluenceTd"><p align="left">其他参数</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">自定义参数</p></td></tr></tbody></table><ul><li>返回参数说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p align="left">code</p></td><td class="confluenceTd"><p align="left">integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">0</p></td><td class="confluenceTd"><p align="left">状态码：</p><p align="left">0： 成功</p></td></tr><tr><td class="confluenceTd"><p align="left">data.expire\_at</p></td><td class="confluenceTd"><p align="left">timestamp</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">time()+7200</p></td><td class="confluenceTd"><p align="left">warant过期时间，默认：7200秒</p></td></tr><tr><td class="confluenceTd"><p align="left">data.user\_data</p></td><td class="confluenceTd"><p align="left">object</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">SDK 发起商户合法性验证时的自定义参数（保持与请求时一致）</p></td></tr><tr><td class="confluenceTd"><p align="left">data. warrant\_id</p></td><td class="confluenceTd"><p align="left">string</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">请求平台创建SSWarrant时返回的warrant</p></td></tr><tr><td class="confluenceTd"><p align="left">message</p></td><td class="confluenceTd"><p align="left">string</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">success</p></td><td class="confluenceTd"><p align="left">状态描述：</p><p align="left">success: 成功</p><p align="left">Authorise: no appid provided.: 失败，缺少appid</p><p align="left">Authorise: no user\_id provided.：失败，缺少user\_id</p><p align="left">Authorise: no timestamp provided.：失败，缺少 timestamp</p><p align="left">Authorise: no user\_client\_ip provided：失败，缺少 user\_client\_ip</p><p align="left">Authorise: no request\_sign provided.：失败，缺少 request\_sign</p><p align="left">Authorise: invalidate appid.：失败，不合法的 appid</p></td></tr></tbody></table><h6>五、作文批改接口规范</h6><ul><li>请求参数说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p>app\_id</p></td><td class="confluenceTd"><p>String</p></td><td class="confluenceTd"><p>Y</p></td><td class="confluenceTd"><p>None</p></td><td class="confluenceTd"><p>授权商户的 app\_id</p></td></tr><tr><td class="confluenceTd"><p align="left">warrant</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">鉴权参数</p></td></tr><tr><td class="confluenceTd"><p align="left">user\_id</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">生成 warrant 时使用的 user\_id</p></td></tr><tr><td class="confluenceTd"><p align="left">essay\_content</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文内容</p></td></tr><tr><td class="confluenceTd"><p align="left">main\_point</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">‘’</p></td><td class="confluenceTd"><p align="left">作文主题</p></td></tr><tr><td class="confluenceTd"><p align="left">score\_range</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">20-10</p></td><td class="confluenceTd"><p align="left">分数范围：min-max</p></td></tr><tr><td class="confluenceTd"><p align="left">lowest\_words</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">50</p></td><td class="confluenceTd"><p align="left">作文最少字数</p></td></tr></tbody></table><ul><li>返回参数说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p>message</p></td><td class="confluenceTd"><p>String</p></td><td class="confluenceTd"><p>Y</p></td><td class="confluenceTd"><p>Success</p></td><td class="confluenceTd"><p>返回结果描述</p><p>success：成功</p><p>no app\_id provided.：缺少app\_id</p><p>app\_id invalidate.：app\_id不合法</p><p>no warrant provided.：缺少warrant</p><p>engine evalute error.：上游评测结果异常</p><p>no essay\_content provided.：缺少essay\_content</p><p>\[socket error\]：上游socket链接失败</p></td></tr><tr><td class="confluenceTd"><p align="left">errId</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">0</p></td><td class="confluenceTd"><p align="left">状态码</p></td></tr><tr><td class="confluenceTd"><p align="left">response</p></td><td class="confluenceTd"><p align="left">Object</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文批改结果</p></td></tr><tr><td class="confluenceTd"><p align="left">response.total\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，总分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response.origin\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，原始总分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response.grammar\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，语法分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response.lexicon\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，词汇分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response. readability\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，可读性分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response. topic\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，主题分数</p></td></tr><tr><td class="confluenceTd"><p align="left">details</p></td><td class="confluenceTd"><p align="left">Object</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改详情，详见：<a>六、作文批改详情说明</a></p></td></tr><tr><td class="confluenceTd"><p align="left">ret\_time</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">接口返回时间</p></td></tr><tr><td class="confluenceTd"><p align="left">record\_id</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求的唯一标识</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times</p></td><td class="confluenceTd"><p align="left">Object</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">关键事件耗时</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times.http\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">整个评测过程耗时，单位：s</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times. upstream\_socket\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">Socket建立耗时，单位：s</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times. upstream\_score\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文整体分数评测耗时，单位：s</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times. upstream\_topic\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文主题分数评测耗时，单位：s</p><p align="left"> </p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times. upstream\_ngec\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文句子详情评测耗时，单位：s</p></td></tr><tr><td class="confluenceTd"><p align="left">request</p></td><td class="confluenceTd"><p align="left">Object</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">请求参数</p></td></tr><tr><td class="confluenceTd"><p align="left">request.app\_id</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">授权的商户 app\_id</p></td></tr><tr><td class="confluenceTd"><p align="left">request.warrant</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求使用的warrant参数</p></td></tr><tr><td class="confluenceTd"><p align="left">request.user\_id</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求的商户端 user\_id，需与获取 warrant 时使用的user\_is保持一致</p></td></tr><tr><td class="confluenceTd"><p align="left">request.essay\_content</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求时提供的作文内容</p></td></tr><tr><td class="confluenceTd"><p align="left">request.score\_range</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求时提供的分数范围参数</p></td></tr><tr><td class="confluenceTd"><p align="left">request.lowest\_words</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求时提供的最少字数参数</p></td></tr><tr><td class="confluenceTd"><p align="left">request.main\_point</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求时提供的主题参数</p></td></tr></tbody></table><h6>六、作文批改详情说明</h6><ul><li>句子详情说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p>origin</p></td><td class="confluenceTd"><p>String</p></td><td class="confluenceTd"><p>Y</p></td><td class="confluenceTd"><p>None</p></td><td class="confluenceTd"><p>原始句子</p></td></tr><tr><td class="confluenceTd"><p align="left">errors</p></td><td class="confluenceTd"><p align="left">Array</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">\[\]</p></td><td class="confluenceTd"><p align="left">句子中出现的错误，详见：<a href="file:///C:/Users/Administrator/Desktop/%E5%85%88%E5%A3%B0%E6%95%99%E8%82%B2%E4%BD%9C%E6%96%87%E6%89%B9%E6%94%B9%E6%8E%A5%E5%85%A5%E6%B5%81%E7%A8%8B.docx#\_2._错误类型说明">2. 错误类型说明</a></p></td></tr><tr><td class="confluenceTd"><p align="left">para\_id</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">段落位置</p></td></tr><tr><td class="confluenceTd"><p align="left">sent\_id</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">句子位置</p></td></tr><tr><td class="confluenceTd"><p align="left">correct</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">改正后的句子</p></td></tr><tr><td class="confluenceTd"><p align="left">typo\_suggestions</p></td><td class="confluenceTd"><p align="left">Array</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">拼写建议，详见：<a href="file:///C:/Users/Administrator/Desktop/%E5%85%88%E5%A3%B0%E6%95%99%E8%82%B2%E4%BD%9C%E6%96%87%E6%89%B9%E6%94%B9%E6%8E%A5%E5%85%A5%E6%B5%81%E7%A8%8B.docx#\_3._拼写建议详情">3. 拼写建议详情</a></p></td></tr></tbody></table><ul><li>错误类型说明</li></ul><p>大小写错误：\[‘uppercase’, 单词位置,’错误单词’，’改正后单词’\]</p><p>冠词错误：\[‘article,’单词位置,’错误单词’,’改正后单词’\]</p><p>单复数错误：\[‘singular-plural’,单词位置,’错误单词’，’改正后单词’\]</p><p>动词形式错误：\[‘verb-form’,单词位置,’错误单词’，’改正后单词’\]</p><p>介词错误：\[‘preposition’, 单词位置，’错误单词’，’改正后单词’\]</p><p>拼写错误: \[‘typo’, 单词位置, ‘错误单词’，’改正后单词’\]</p><p>词性错误: \[‘pos-error’, 单词位置, ‘错误单词’，’改正后单词’\]</p><p>情态动词错误：\[‘modal-verbs’, 单词位置, ‘错误单词’, ‘改正后单词’\]</p><p>其他错误：\[‘others’, 单词位置, ‘错误单词’, ‘改正后单词’\]</p><p>删除多余词：\[‘deletion’, 单词位置,’删除单词’\]</p><p>丢失目标单词：<span style="color: rgb(25,31,37);">\[‘insertion’, 单词丢失位置，丢失单词\]</span></p><ul><li>拼写建议详情</li></ul><p>\[‘被建议单词’,单词位置,建议单词1,建议单词2,建议单词3,......\]</p><h6>七、请求示例</h6><ul><li>请求示例</li></ul><table class="wysiwyg-macro" data-macro-name="code" data-macro-id="813ed5c5-8131-4568-a987-b18c99f973f0" data-macro-parameters="language=powershell|linenumbers=true|theme=Midnight|title=请求示例" data-macro-schema-version="1" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6bGFuZ3VhZ2U9cG93ZXJzaGVsbHx0aGVtZT1NaWRuaWdodHx0aXRsZT3or7fmsYLnpLrkvot8bGluZW51bWJlcnM9dHJ1ZX0&amp;locale=zh\_CN&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN\_TEXT"><tr><td class="wysiwyg-macro-body"><pre>curl -X POST \ 'http://aes.ssapi.cn/index.php?action=essayEvalute' \ -H 'cache-control: no-cache' \ -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \ -H 'postman-token: 3611dbab-8f7f-6ee2-f4bf-0d45bde895dc' \ -F app\_id=t12 \ -F warrant=0x5ac1d57055c74dfc7d87c1fc83dc1542 \ -F user\_id=123 \ -F 'essay\_content=I'\\''m honoured that you show great interest in our trains. And the reason why I writing is intructing our trains vehicle to you.&lt;/PAR> chiese trains have three kinds. The HSR is the fastest and it'\\''s speed can up to 300 km/h. The CRH is little slower than HSRm only 200 km/h. The Express is devided into three different kinds, I, Z and K . You can accoring your require to choose different trains. And you can appreciate the summery in a low price. I think you will be worried about danger. I'\\''m sure the trains are completely safe. Even though, some accident are token place occasional, we will have different ways to solve different bad condition. I'\\''m sure you will have a good time. Looking forward to your coming.' \ -F 'main\_point=trains HSR CRH Express speed I'\\''m honoured that you show great interest in our trains. ' \ -F score\_range=20-100 \ -F lowest\_words=50</pre></td></tr></table><ul><li>返回示例</li></ul><div><p> </p><table class="wysiwyg-macro" data-macro-name="code" data-macro-id="49a67307-5410-4468-82f2-0ed87242463b" data-macro-parameters="language=js|linenumbers=true|theme=Midnight|title=返回示例" data-macro-schema-version="1" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6bGFuZ3VhZ2U9anN8dGhlbWU9TWlkbmlnaHR8dGl0bGU96L-U5Zue56S65L6LfGxpbmVudW1iZXJzPXRydWV9&amp;locale=zh\_CN&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN\_TEXT"><tr><td class="wysiwyg-macro-body"><pre>{ "message": "success", "errId": 0, "response": { "total\_score": 88, "origin\_score": 83, "grammar\_score": 7, "lexicon\_score": 10, "readability\_score": 8, "topic\_score": 9, "details": \[ { "origin": "You can accoring your require to choose different trains.", "errors": \[ \[ "typo", 2, "accoring", "access" \], \[ "singular-plural", 4, "require", "requirements" \] \], "para\_id": 1, "sent\_id": 6, "typo\_suggestions": \[\], "correct": "You can access your requirements to choose different trains ." }, { "origin": "And you can appreciate the summery in a low price.", "errors": \[ \[ "others", 5, "summery", "summary" \], \[ "preposition", 6, "in", "of" \] \], "para\_id": 1, "sent\_id": 7, "typo\_suggestions": \[\], "correct": "And you can appreciate the summary of a low price ." }, { "origin": "I'm honoured that you show great interest in our trains.", "errors": \[ \[ "typo", 1, "honoured", "honored" \], \[ "singular-plural", 9, "trains", "train" \] \], "para\_id": 0, "sent\_id": 0, "typo\_suggestions": \[\], "correct": "I 'm honored that you show great interest in our train ." }, { "origin": "And the reason why I writing is intructing our trains vehicle to you.", "errors": \[ \[ "insertion", 4, "am" \], \[ "insertion", 6, "to" \], \[ "verb-form", 7, "intructing", "introduce", "VBG", "VB" \] \], "para\_id": 0, "sent\_id": 1, "typo\_suggestions": \[\], "correct": "And the reason why I am writing is to introduce our trains vehicle to you ." }, { "origin": "chiese trains have three kinds.", "errors": \[ \[ "typo", 0, "chiese", "there" \], \[ "deletion", 1, "trains" \], \[ "others", 2, "have", "are" \], \[ "insertion", 4, "of" \], \[ "insertion", 4, "chinese" \], \[ "insertion", 4, "trains" \] \], "para\_id": 1, "sent\_id": 2, "typo\_suggestions": \[\], "correct": "There are three kinds of chinese trains ." }, { "origin": "Looking forward to your coming.", "errors": \[ \[ "others", 4, "coming", "arrival" \] \], "para\_id": 1, "sent\_id": 12, "typo\_suggestions": \[\], "correct": "Looking forward to your arrival ." }, { "origin": "The Express is devided into three different kinds, I, Z and K .", "errors": \[ \[ "typo", 3, "devided", "divided" \] \], "para\_id": 1, "sent\_id": 5, "typo\_suggestions": \[\], "correct": "The Express is divided into three different kinds , I , Z and K ." }, { "origin": "I'm sure you will have a good time.", "errors": \[\], "para\_id": 1, "sent\_id": 11, "typo\_suggestions": \[\], "correct": "I 'm sure you will have a good time ." }, { "origin": "I think you will be worried about danger.", "errors": \[\], "para\_id": 1, "sent\_id": 8, "typo\_suggestions": \[\], "correct": "I think you will be worried about danger ." }, { "origin": "I'm sure the trains are completely safe.", "errors": \[ \[ "insertion", 1, "that" \] \], "para\_id": 1, "sent\_id": 9, "typo\_suggestions": \[\], "correct": "I 'm sure that the trains are completely safe ." }, { "origin": "Even though, some accident are token place occasional, we will have different ways to solve different bad condition.", "errors": \[ \[ "deletion", 1, "," \], \[ "singular-plural", 3, "accident", "accidents" \], \[ "others", 5, "token", "taking" \], \[ "pos-error", 7, "occasional", "occasionally", "JJ", "RB" \], \[ "deletion", 16, "bad" \], \[ "singular-plural", 17, "condition", "conditions" \] \], "para\_id": 1, "sent\_id": 10, "typo\_suggestions": \[\], "correct": "Even though some accidents are taking place occasionally , we will have different ways to solve different conditions ." }, { "origin": "The HSR is the fastest and it's speed can up to 300 km/h.", "errors": \[ \[ "singular-plural", 1, "HSR", "hr" \], \[ "pos-error", 6, "it", "its", "PRP", "PRP$" \], \[ "deletion", 6, "'s" \] \], "para\_id": 1, "sent\_id": 3, "typo\_suggestions": \[\], "correct": "The hr is the fastest and its speed can up to 300 km/h ." }, { "origin": "The CRH is little slower than HSRm only 200 km/h.", "errors": \[ \[ "insertion", 2, "a" \], \[ "insertion", 5, "the" \] \], "para\_id": 1, "sent\_id": 4, "typo\_suggestions": \[\], "correct": "The CRH is a little slower than the HSRm only 200 km/h ." } \] }, "event\_times": { "http\_time": 3.028, "upstream\_socket\_time": 0.001, "upstream\_score\_time": 0.051, "upstream\_topic\_time": 0.054, "upstream\_ngec\_time": 2.918 }, "ret\_time": "2018-03-30 10:48:32.912", "request": { "app\_id": "t120", "warrant": "0x5abdc198914ad3413702ad6f52698bf65", "user\_id": "123", "essay\_content": "I'm honoured that you show great interest in our trains. And the reason why I writing is intructing our trains vehicle to you.&lt;/PAR> chiese trains have three kinds. The HSR is the fastest and it's speed can up to 300 km/h. The CRH is little slower than HSRm only 200 km/h. The Express is devided into three different kinds, I, Z and K . You can accoring your require to choose different trains. And you can appreciate the summery in a low price. I think you will be worried about danger. I'm sure the trains are completely safe. Even though, some accident are token place occasional, we will have different ways to solve different bad condition. I'm sure you will have a good time. Looking forward to your coming.", "main\_point": "trains HSR CRH Express speed I'm honoured that you show great interest in our trains. ", "score\_range": "20-100", "lowest\_words": "50" }, "record\_id": "11e8d40a6c78t12013813" }</pre></td></tr></table><p>八、错误码说明</p><table class="confluenceTable"><tbody><tr><th class="confluenceTh">错误码</th><th class="confluenceTh">错误码说明</th></tr><tr><td class="confluenceTd">-1</td><td class="confluenceTd">
action=essayEvalute">http://aes.ssapi.cn/index.php?action=essayEvalute</a> </strong></p><p><strong>替代商户权限系统地址：<a href="http://warrant.ssapi.cn">http://warrant.ssapi.cn</a></strong></p><h6>一、获取 appid 和 app\_secret</h6><p>商务沟通，提供邮箱获取先声教育的商户授权 appid 和 app\_secret。</p><h6>二、服务端搭建《商户授权服务》</h6><ol><li>git clone <a href="mailto:git@pt.singsound.com:singsound-platform/warrant-client-php.git">git@pt.singsound.com:singsound-platform/warrant-client-php.git</a></li><li>cd warrant-client-php &amp;&amp; mv .env.dist .env</li><li>composer install</li><li>vim .env</li><li> vim index.php</li></ol><h6>三、发起作文批改请求</h6><ul><li>访问服务端的《商户授权服务》获取 warrant 参数。</li></ul><p>详见：四、<a>商户授权服务接口规范</a></p><ul><li>使用 warrant 参数以及《先声作文批改》接口参数，发起作文批改请求</li></ul><p>详见：<a>五、作文批改接口规范</a></p><h6>四、商户授权服务接口规范</h6><ul><li>请求参数说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p align="left">user\_id</p></td><td class="confluenceTd"><p align="left">string</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">''</p></td><td class="confluenceTd"><p align="left">商户自身的user\_id，用于warrant区分不同用户</p></td></tr><tr><td class="confluenceTd"><p align="left">其他参数</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">自定义参数</p></td></tr></tbody></table><ul><li>返回参数说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p align="left">code</p></td><td class="confluenceTd"><p align="left">integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">0</p></td><td class="confluenceTd"><p align="left">状态码：</p><p align="left">0： 成功</p></td></tr><tr><td class="confluenceTd"><p align="left">data.expire\_at</p></td><td class="confluenceTd"><p align="left">timestamp</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">time()+7200</p></td><td class="confluenceTd"><p align="left">warant过期时间，默认：7200秒</p></td></tr><tr><td class="confluenceTd"><p align="left">data.user\_data</p></td><td class="confluenceTd"><p align="left">object</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">SDK 发起商户合法性验证时的自定义参数（保持与请求时一致）</p></td></tr><tr><td class="confluenceTd"><p align="left">data. warrant\_id</p></td><td class="confluenceTd"><p align="left">string</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">---</p></td><td class="confluenceTd"><p align="left">请求平台创建SSWarrant时返回的warrant</p></td></tr><tr><td class="confluenceTd"><p align="left">message</p></td><td class="confluenceTd"><p align="left">string</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">success</p></td><td class="confluenceTd"><p align="left">状态描述：</p><p align="left">success: 成功</p><p align="left">Authorise: no appid provided.: 失败，缺少appid</p><p align="left">Authorise: no user\_id provided.：失败，缺少user\_id</p><p align="left">Authorise: no timestamp provided.：失败，缺少 timestamp</p><p align="left">Authorise: no user\_client\_ip provided：失败，缺少 user\_client\_ip</p><p align="left">Authorise: no request\_sign provided.：失败，缺少 request\_sign</p><p align="left">Authorise: invalidate appid.：失败，不合法的 appid</p></td></tr></tbody></table><h6>五、作文批改接口规范</h6><ul><li>请求参数说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p>app\_id</p></td><td class="confluenceTd"><p>String</p></td><td class="confluenceTd"><p>Y</p></td><td class="confluenceTd"><p>None</p></td><td class="confluenceTd"><p>授权商户的 app\_id</p></td></tr><tr><td class="confluenceTd"><p align="left">warrant</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">鉴权参数</p></td></tr><tr><td class="confluenceTd"><p align="left">user\_id</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">生成 warrant 时使用的 user\_id</p></td></tr><tr><td class="confluenceTd"><p align="left">essay\_content</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文内容</p></td></tr><tr><td class="confluenceTd"><p align="left">main\_point</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">‘’</p></td><td class="confluenceTd"><p align="left">作文主题</p></td></tr><tr><td class="confluenceTd"><p align="left">score\_range</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">20-10</p></td><td class="confluenceTd"><p align="left">分数范围：min-max</p></td></tr><tr><td class="confluenceTd"><p align="left">lowest\_words</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">N</p></td><td class="confluenceTd"><p align="left">50</p></td><td class="confluenceTd"><p align="left">作文最少字数</p></td></tr></tbody></table><ul><li>返回参数说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p>message</p></td><td class="confluenceTd"><p>String</p></td><td class="confluenceTd"><p>Y</p></td><td class="confluenceTd"><p>Success</p></td><td class="confluenceTd"><p>返回结果描述</p><p>success：成功</p><p>no app\_id provided.：缺少app\_id</p><p>app\_id invalidate.：app\_id不合法</p><p>no warrant provided.：缺少warrant</p><p>engine evalute error.：上游评测结果异常</p><p>no essay\_content provided.：缺少essay\_content</p><p>\[socket error\]：上游socket链接失败</p></td></tr><tr><td class="confluenceTd"><p align="left">errId</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">0</p></td><td class="confluenceTd"><p align="left">状态码</p></td></tr><tr><td class="confluenceTd"><p align="left">response</p></td><td class="confluenceTd"><p align="left">Object</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文批改结果</p></td></tr><tr><td class="confluenceTd"><p align="left">response.total\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，总分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response.origin\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，原始总分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response.grammar\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，语法分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response.lexicon\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，词汇分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response. readability\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，可读性分数</p></td></tr><tr><td class="confluenceTd"><p align="left">response. topic\_score</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改结果，主题分数</p></td></tr><tr><td class="confluenceTd"><p align="left">details</p></td><td class="confluenceTd"><p align="left">Object</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">批改详情，详见：<a>六、作文批改详情说明</a></p></td></tr><tr><td class="confluenceTd"><p align="left">ret\_time</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">接口返回时间</p></td></tr><tr><td class="confluenceTd"><p align="left">record\_id</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求的唯一标识</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times</p></td><td class="confluenceTd"><p align="left">Object</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">关键事件耗时</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times.http\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">整个评测过程耗时，单位：s</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times. upstream\_socket\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">Socket建立耗时，单位：s</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times. upstream\_score\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文整体分数评测耗时，单位：s</p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times. upstream\_topic\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文主题分数评测耗时，单位：s</p><p align="left"> </p></td></tr><tr><td class="confluenceTd"><p align="left">event\_times. upstream\_ngec\_time</p></td><td class="confluenceTd"><p align="left">Float</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">作文句子详情评测耗时，单位：s</p></td></tr><tr><td class="confluenceTd"><p align="left">request</p></td><td class="confluenceTd"><p align="left">Object</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">请求参数</p></td></tr><tr><td class="confluenceTd"><p align="left">request.app\_id</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">授权的商户 app\_id</p></td></tr><tr><td class="confluenceTd"><p align="left">request.warrant</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求使用的warrant参数</p></td></tr><tr><td class="confluenceTd"><p align="left">request.user\_id</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求的商户端 user\_id，需与获取 warrant 时使用的user\_is保持一致</p></td></tr><tr><td class="confluenceTd"><p align="left">request.essay\_content</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求时提供的作文内容</p></td></tr><tr><td class="confluenceTd"><p align="left">request.score\_range</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求时提供的分数范围参数</p></td></tr><tr><td class="confluenceTd"><p align="left">request.lowest\_words</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求时提供的最少字数参数</p></td></tr><tr><td class="confluenceTd"><p align="left">request.main\_point</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">本次请求时提供的主题参数</p></td></tr></tbody></table><h6>六、作文批改详情说明</h6><ul><li>句子详情说明</li></ul><table class="confluenceTable"><thead><tr><td class="confluenceTd"><p align="left"><strong>参数名称</strong></p></td><td class="confluenceTd"><p align="left"><strong>类型</strong></p></td><td class="confluenceTd"><p align="left"><strong>是否必须</strong></p></td><td class="confluenceTd"><p align="left"><strong>默认值</strong></p></td><td class="confluenceTd"><p align="left"><strong>描述</strong></p></td></tr></thead><tbody><tr><td class="confluenceTd"><p>origin</p></td><td class="confluenceTd"><p>String</p></td><td class="confluenceTd"><p>Y</p></td><td class="confluenceTd"><p>None</p></td><td class="confluenceTd"><p>原始句子</p></td></tr><tr><td class="confluenceTd"><p align="left">errors</p></td><td class="confluenceTd"><p align="left">Array</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">\[\]</p></td><td class="confluenceTd"><p align="left">句子中出现的错误，详见：<a href="file:///C:/Users/Administrator/Desktop/%E5%85%88%E5%A3%B0%E6%95%99%E8%82%B2%E4%BD%9C%E6%96%87%E6%89%B9%E6%94%B9%E6%8E%A5%E5%85%A5%E6%B5%81%E7%A8%8B.docx#\_2._错误类型说明">2. 错误类型说明</a></p></td></tr><tr><td class="confluenceTd"><p align="left">para\_id</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">段落位置</p></td></tr><tr><td class="confluenceTd"><p align="left">sent\_id</p></td><td class="confluenceTd"><p align="left">Integer</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">句子位置</p></td></tr><tr><td class="confluenceTd"><p align="left">correct</p></td><td class="confluenceTd"><p align="left">String</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">改正后的句子</p></td></tr><tr><td class="confluenceTd"><p align="left">typo\_suggestions</p></td><td class="confluenceTd"><p align="left">Array</p></td><td class="confluenceTd"><p align="left">Y</p></td><td class="confluenceTd"><p align="left">None</p></td><td class="confluenceTd"><p align="left">拼写建议，详见：<a href="file:///C:/Users/Administrator/Desktop/%E5%85%88%E5%A3%B0%E6%95%99%E8%82%B2%E4%BD%9C%E6%96%87%E6%89%B9%E6%94%B9%E6%8E%A5%E5%85%A5%E6%B5%81%E7%A8%8B.docx#\_3._拼写建议详情">3. 拼写建议详情</a></p></td></tr></tbody></table><ul><li>错误类型说明</li></ul><p>大小写错误：\[‘uppercase’, 单词位置,’错误单词’，’改正后单词’\]</p><p>冠词错误：\[‘article,’单词位置,’错误单词’,’改正后单词’\]</p><p>单复数错误：\[‘singular-plural’,单词位置,’错误单词’，’改正后单词’\]</p><p>动词形式错误：\[‘verb-form’,单词位置,’错误单词’，’改正后单词’\]</p><p>介词错误：\[‘preposition’, 单词位置，’错误单词’，’改正后单词’\]</p><p>拼写错误: \[‘typo’, 单词位置, ‘错误单词’，’改正后单词’\]</p><p>词性错误: \[‘pos-error’, 单词位置, ‘错误单词’，’改正后单词’\]</p><p>情态动词错误：\[‘modal-verbs’, 单词位置, ‘错误单词’, ‘改正后单词’\]</p><p>其他错误：\[‘others’, 单词位置, ‘错误单词’, ‘改正后单词’\]</p><p>删除多余词：\[‘deletion’, 单词位置,’删除单词’\]</p><p>丢失目标单词：<span style="color: rgb(25,31,37);">\[‘insertion’, 单词丢失位置，丢失单词\]</span></p><ul><li>拼写建议详情</li></ul><p>\[‘被建议单词’,单词位置,建议单词1,建议单词2,建议单词3,......\]</p><h6>七、请求示例</h6><ul><li>请求示例</li></ul><table class="wysiwyg-macro" data-macro-name="code" data-macro-id="813ed5c5-8131-4568-a987-b18c99f973f0" data-macro-parameters="language=powershell|linenumbers=true|theme=Midnight|title=请求示例" data-macro-schema-version="1" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6bGFuZ3VhZ2U9cG93ZXJzaGVsbHx0aGVtZT1NaWRuaWdodHx0aXRsZT3or7fmsYLnpLrkvot8bGluZW51bWJlcnM9dHJ1ZX0&amp;locale=zh\_CN&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN\_TEXT"><tr><td class="wysiwyg-macro-body">curl -X POST \ 'http://aes.ssapi.cn/index.php?action=essayEvalute' \ -H 'cache-control: no-cache' \ -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \ -H 'postman-token: 3611dbab-8f7f-6ee2-f4bf-0d45bde895dc' \ -F app\_id=t12 \ -F warrant=0x5ac1d57055c74dfc7d87c1fc83dc1542 \ -F user\_id=123 \ -F 'essay\_content=I'\\''m honoured that you show great interest in our trains. And the reason why I writing is intructing our trains vehicle to you.&lt;/PAR> chiese trains have three kinds. The HSR is the fastest and it'\\''s speed can up to 300 km/h. The CRH is little slower than HSRm only 200 km/h. The Express is devided into three different kinds, I, Z and K . You can accoring your require to choose different trains. And you can appreciate the summery in a low price. I think you will be worried about danger. I'\\''m sure the trains are completely safe. Even though, some accident are token place occasional, we will have different ways to solve different bad condition. I'\\''m sure you will have a good time. Looking forward to your coming.' \ -F 'main\_point=trains HSR CRH Express speed I'\\''m honoured that you show great interest in our trains. ' \ -F score\_range=20-100 \ -F lowest\_words=50</td></tr></table><ul><li>返回示例</li></ul><div><p> </p><table class="wysiwyg-macro" data-macro-name="code" data-macro-id="49a67307-5410-4468-82f2-0ed87242463b" data-macro-parameters="language=js|linenumbers=true|theme=Midnight|title=返回示例" data-macro-schema-version="1" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6bGFuZ3VhZ2U9anN8dGhlbWU9TWlkbmlnaHR8dGl0bGU96L-U5Zue56S65L6LfGxpbmVudW1iZXJzPXRydWV9&amp;locale=zh\_CN&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN\_TEXT"><tr><td class="wysiwyg-macro-body">{ "message": "success", "errId": 0, "response": { "total\_score": 88, "origin\_score": 83, "grammar\_score": 7, "lexicon\_score": 10, "readability\_score": 8, "topic\_score": 9, "details": \[ { "origin": "You can accoring your require to choose different trains.", "errors": \[ \[ "typo", 2, "accoring", "access" \], \[ "singular-plural", 4, "require", "requirements" \] \], "para\_id": 1, "sent\_id": 6, "typo\_suggestions": \[\], "correct": "You can access your requirements to choose different trains ." }, { "origin": "And you can appreciate the summery in a low price.", "errors": \[ \[ "others", 5, "summery", "summary" \], \[ "preposition", 6, "in", "of" \] \], "para\_id": 1, "sent\_id": 7, "typo\_suggestions": \[\], "correct": "And you can appreciate the summary of a low price ." }, { "origin": "I'm honoured that you show great interest in our trains.", "errors": \[ \[ "typo", 1, "honoured", "honored" \], \[ "singular-plural", 9, "trains", "train" \] \], "para\_id": 0, "sent\_id": 0, "typo\_suggestions": \[\], "correct": "I 'm honored that you show great interest in our train ." }, { "origin": "And the reason why I writing is intructing our trains vehicle to you.", "errors": \[ \[ "insertion", 4, "am" \], \[ "insertion", 6, "to" \], \[ "verb-form", 7, "intructing", "introduce", "VBG", "VB" \] \], "para\_id": 0, "sent\_id": 1, "typo\_suggestions": \[\], "correct": "And the reason why I am writing is to introduce our trains vehicle to you ." }, { "origin": "chiese trains have three kinds.", "errors": \[ \[ "typo", 0, "chiese", "there" \], \[ "deletion", 1, "trains" \], \[ "others", 2, "have", "are" \], \[ "insertion", 4, "of" \], \[ "insertion", 4, "chinese" \], \[ "insertion", 4, "trains" \] \], "para\_id": 1, "sent\_id": 2, "typo\_suggestions": \[\], "correct": "There are three kinds of chinese trains ." }, { "origin": "Looking forward to your coming.", "errors": \[ \[ "others", 4, "coming", "arrival" \] \], "para\_id": 1, "sent\_id": 12, "typo\_suggestions": \[\], "correct": "Looking forward to your arrival ." }, { "origin": "The Express is devided into three different kinds, I, Z and K .", "errors": \[ \[ "typo", 3, "devided", "divided" \] \], "para\_id": 1, "sent\_id": 5, "typo\_suggestions": \[\], "correct": "The Express is divided into three different kinds , I , Z and K ." }, { "origin": "I'm sure you will have a good time.", "errors": \[\], "para\_id": 1, "sent\_id": 11, "typo\_suggestions": \[\], "correct": "I 'm sure you will have a good time ." }, { "origin": "I think you will be worried about danger.", "errors": \[\], "para\_id": 1, "sent\_id": 8, "typo\_suggestions": \[\], "correct": "I think you will be worried about danger ." }, { "origin": "I'm sure the trains are completely safe.", "errors": \[ \[ "insertion", 1, "that" \] \], "para\_id": 1, "sent\_id": 9, "typo\_suggestions": \[\], "correct": "I 'm sure that the trains are completely safe ." }, { "origin": "Even though, some accident are token place occasional, we will have different ways to solve different bad condition.", "errors": \[ \[ "deletion", 1, "," \], \[ "singular-plural", 3, "accident", "accidents" \], \[ "others", 5, "token", "taking" \], \[ "pos-error", 7, "occasional", "occasionally", "JJ", "RB" \], \[ "deletion", 16, "bad" \], \[ "singular-plural", 17, "condition", "conditions" \] \], "para\_id": 1, "sent\_id": 10, "typo\_suggestions": \[\], "correct": "Even though some accidents are taking place occasionally , we will have different ways to solve different conditions ." }, { "origin": "The HSR is the fastest and it's speed can up to 300 km/h.", "errors": \[ \[ "singular-plural", 1, "HSR", "hr" \], \[ "pos-error", 6, "it", "its", "PRP", "PRP$" \], \[ "deletion", 6, "'s" \] \], "para\_id": 1, "sent\_id": 3, "typo\_suggestions": \[\], "correct": "The hr is the fastest and its speed can up to 300 km/h ." }, { "origin": "The CRH is little slower than HSRm only 200 km/h.", "errors": \[ \[ "insertion", 2, "a" \], \[ "insertion", 5, "the" \] \], "para\_id": 1, "sent\_id": 4, "typo\_suggestions": \[\], "correct": "The CRH is a little slower than the HSRm only 200 km/h ." } \] }, "event\_times": { "http\_time": 3.028, "upstream\_socket\_time": 0.001, "upstream\_score\_time": 0.051, "upstream\_topic\_time": 0.054, "upstream\_ngec\_time": 2.918 }, "ret\_time": "2018-03-30 10:48:32.912", "request": { "app\_id": "t120", "warrant": "0x5abdc198914ad3413702ad6f52698bf65", "user\_id": "123", "essay\_content": "I'm honoured that you show great interest in our trains. And the reason why I writing is intructing our trains vehicle to you.&lt;/PAR> chiese trains have three kinds. The HSR is the fastest and it's speed can up to 300 km/h. The CRH is little slower than HSRm only 200 km/h. The Express is devided into three different kinds, I, Z and K . You can accoring your require to choose different trains. And you can appreciate the summery in a low price. I think you will be worried about danger. I'm sure the trains are completely safe. Even though, some accident are token place occasional, we will have different ways to solve different bad condition. I'm sure you will have a good time. Looking forward to your coming.", "main\_point": "trains HSR CRH Express speed I'm honoured that you show great interest in our trains. ", "score\_range": "20-100", "lowest\_words": "50" }, "record\_id": "11e8d40a6c78t12013813" }</td></tr></table><p>八、错误码说明</p><table class="confluenceTable"><tbody><tr><th class="confluenceTh">错误码</th><th class="confluenceTh">错误码说明</th></tr><tr><td class="confluenceTd">-1</td><td class="confluenceTd">
系统错误</td></tr><tr><td class="confluenceTd">0</td><td class="confluenceTd">成功</td></tr><tr><td class="confluenceTd">210001</td><td class="confluenceTd">授权时，不合法的appid</td></tr><tr><td class="confluenceTd">210002</td><td class="confluenceTd">授权时，不合法的user\_id</td></tr><tr><td class="confluenceTd">210003</td><td class="confluenceTd">授权时，不合法的tiemstamp</td></tr><tr><td class="confluenceTd">210004</td><td class="confluenceTd">授权时，不合法的user\_client\_ip</td></tr><tr><td class="confluenceTd">210005</td><td class="confluenceTd">授权时，不合法的request\_sign</td></tr><tr><td class="confluenceTd">210006</td><td class="confluenceTd">授权时，不合法的appid</td></tr><tr><td class="confluenceTd">210007</td><td class="confluenceTd">授权时，不合法的request\_sign</td></tr><tr><td class="confluenceTd">220001</td><td class="confluenceTd">评测时，缺少 app\_id</td></tr><tr><td class="confluenceTd">220002</td><td class="confluenceTd">评测时，缺少 warrant</td></tr><tr><td class="confluenceTd">220003</td><td class="confluenceTd">评测时，warrant 过期</td></tr><tr><td class="confluenceTd">220004</td><td class="confluenceTd">评测时，不合法的 app\_id</td></tr><tr><td class="confluenceTd">220005</td><td class="confluenceTd">评测时，不合法的 warrant</td></tr><tr><td class="confluenceTd">220006</td><td class="confluenceTd">评测时，缺少 essay_content</pre></td></tr><tr><td class="confluenceTd">230001</td><td class="confluenceTd">评测引擎错误，未获得评测结果</td></tr><tr><td class="confluenceTd">230002</td><td class="confluenceTd">评测引擎错误，链接失败</td></tr><tr><td class="confluenceTd">240001</td><td class="confluenceTd">系统错误，创建 UUID 失败</td></tr><tr><td class="confluenceTd">240002</td><td class="confluenceTd">系统错误，错误的 redis 配置信息</td></tr><tr><td colspan="1" class="confluenceTd">240003</td><td colspan="1" class="confluenceTd">系统错误，链接 redis 失败</td></tr></tbody></table><p> </p><p> </p></div>
\ No newline at end of file