For Developers
把 Turnitin 查重接进你的产品。
Managed API Key 使用 REST API + SSE 事件流。上传、报价和提交共享客户额度与可恢复的 submission 记录；创建请求必须携带 Idempotency-Key。
API 概览
上传、报价、提交和报告读取。
| Method | Path | 说明 |
|---|---|---|
POST | /v1/uploads | 上传 PDF、DOCX 或 TXT，获得 owner-scoped upload_id |
POST | /v1/submissions/quote | 冻结报告组合、路由和额度成本 |
POST | /v1/submissions | 携带 Idempotency-Key 与 quote_id 创建提交 |
GET | /v1/submissions/:id | 读取提交状态、报告可用性和分数摘要 |
GET | /v1/submissions/:id/events | SSE：submission_status 与 job_event |
GET | /v1/submissions/:id/report | 读取 JSON 报告元数据和结构化内容 |
GET | /v1/submissions/:id/report/file | 下载 similarity 或 AI 报告文件 |
失败码
平台侧失败会自动兜底。
所有 Turnitin 侧异常都会转成结构化失败码。以 submission 的终态和报告可用性为准；平台侧终态失败按原额度分配退款。
| Code | 含义 |
|---|---|
login_failed | 我们这侧账号登录失败,会自动重试 |
turnitin_blocked | Turnitin 临时风控,进入重排队 |
upload_failed | 文档上传阶段失败 |
report_timeout | 报告轮询超时(> 10 分钟) |
system_error | 内部未分类错误 |
机构 / 平台采购
批量兑换码与 API 接入。
需要发放给学生 / 内容审核员 / 客户的平台,可以生成批量兑换码(单次一码、不可复用),由他们在 /app/redeem 自助激活。当前不提供月结或发票服务。
有 API 接入、批量兑换码、定制 SLA 的需求?直接发邮件给support@njbejm.cn, 我们通常 1 个工作日内回。