{"openapi":"3.0.0","info":{"title":"Workfuse Public API","version":"0.0.104-api"},"servers":[{"url":"https://api.workfuse.com/public/v1","description":"Workfuse Public API"}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer"}},"schemas":{"ErrorResponse":{"type":"object","properties":{"errorCode":{"type":"string"},"message":{"type":"string"}},"required":["errorCode","message"]}},"parameters":{}},"paths":{"/correction/essays":{"post":{"summary":"Enviar redação para correção (assíncrono)","tags":["Correction"],"security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1,"maxLength":50000},"userId":{"type":"string","minLength":1,"maxLength":255},"proposedTheme":{"type":"string","minLength":1,"maxLength":2000},"motivationalTexts":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"content":{"type":"string","nullable":true},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string","nullable":true},"source":{"type":"string","nullable":true}},"required":["url"]}}},"required":["title"]}},"title":{"type":"string","maxLength":500},"externalId":{"type":"string","maxLength":255},"mode":{"type":"string","enum":["online","offline"]}},"required":["content","userId","proposedTheme","motivationalTexts"]}}}},"responses":{"201":{"description":"Redação recebida e enfileirada (processStatus: PENDING)","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"processStatus":{"type":"string"}},"required":["id","processStatus"]}}}},"400":{"description":"Dados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"API key ausente ou inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Módulo não permitido para esta chave/instituição","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Erro interno"}}},"get":{"summary":"Listar redações da instituição","tags":["Correction"],"security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":0,"exclusiveMinimum":true,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":0,"exclusiveMinimum":true,"default":20},"required":false,"name":"pageSize","in":"query"},{"schema":{"type":"string"},"required":false,"name":"userId","in":"query"},{"schema":{"type":"string","enum":["PENDING","PROCESSING","SUCCESS","ERROR"]},"required":false,"name":"processStatus","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"to","in":"query"}],"responses":{"200":{"description":"Lista paginada de redações","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","example":1},"pageSize":{"type":"number","example":100},"pages":{"type":"number","example":2},"items":{"type":"number","example":200}},"required":["page","pageSize","pages","items"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string","nullable":true},"content":{"type":"string"},"contentWithGrammarFeedback":{"type":"string","nullable":true},"proposedTheme":{"type":"string"},"motivationalTexts":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"content":{"type":"string","nullable":true},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string","nullable":true},"source":{"type":"string","nullable":true}},"required":["url"]}}},"required":["title"]}},"userId":{"type":"string"},"externalId":{"type":"string","nullable":true},"status":{"type":"string","enum":["SENT","DONE"]},"processStatus":{"type":"string","enum":["PENDING","PROCESSING","SUCCESS","ERROR"]},"processErrorMessage":{"type":"string","nullable":true},"correctionModel":{"type":"string"},"enemFeedback":{"type":"object","nullable":true,"properties":{"competence1Score":{"type":"number"},"competence1Comment":{"type":"string","nullable":true},"competence2Score":{"type":"number"},"competence2Comment":{"type":"string","nullable":true},"competence3Score":{"type":"number"},"competence3Comment":{"type":"string","nullable":true},"competence4Score":{"type":"number"},"competence4Comment":{"type":"string","nullable":true},"competence5Score":{"type":"number"},"competence5Comment":{"type":"string","nullable":true},"overallScore":{"type":"number"},"overallComment":{"type":"string","nullable":true},"isScoreZeroed":{"type":"boolean"},"preliminaryCheckComment":{"type":"string","nullable":true},"grammarFeedback":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"shortMessage":{"type":"string"},"replacements":{"type":"array","items":{"type":"string"}},"offset":{"type":"number"},"length":{"type":"number"},"type":{"type":"string","enum":["ortografia","concordancia","pontuacao","regencia","estilo"]}},"required":["message","shortMessage","replacements","offset","length","type"]}}},"required":["competence1Score","competence1Comment","competence2Score","competence2Comment","competence3Score","competence3Comment","competence4Score","competence4Comment","competence5Score","competence5Comment","overallScore","overallComment","isScoreZeroed","preliminaryCheckComment","grammarFeedback"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","title","content","contentWithGrammarFeedback","proposedTheme","motivationalTexts","userId","externalId","status","processStatus","processErrorMessage","correctionModel","enemFeedback","createdAt","updatedAt"]}}},"required":["pagination","data"]}}}},"400":{"description":"Dados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"API key ausente ou inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Módulo não permitido para esta chave/instituição","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Erro interno"}}}},"/correction/essays/:id":{"get":{"summary":"Consultar redação por id","tags":["Correction"],"security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","example":"cuid_example_id"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Redação (enemFeedback nulo até a correção concluir)","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string","nullable":true},"content":{"type":"string"},"contentWithGrammarFeedback":{"type":"string","nullable":true},"proposedTheme":{"type":"string"},"motivationalTexts":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"content":{"type":"string","nullable":true},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string","nullable":true},"source":{"type":"string","nullable":true}},"required":["url"]}}},"required":["title"]}},"userId":{"type":"string"},"externalId":{"type":"string","nullable":true},"status":{"type":"string","enum":["SENT","DONE"]},"processStatus":{"type":"string","enum":["PENDING","PROCESSING","SUCCESS","ERROR"]},"processErrorMessage":{"type":"string","nullable":true},"correctionModel":{"type":"string"},"enemFeedback":{"type":"object","nullable":true,"properties":{"competence1Score":{"type":"number"},"competence1Comment":{"type":"string","nullable":true},"competence2Score":{"type":"number"},"competence2Comment":{"type":"string","nullable":true},"competence3Score":{"type":"number"},"competence3Comment":{"type":"string","nullable":true},"competence4Score":{"type":"number"},"competence4Comment":{"type":"string","nullable":true},"competence5Score":{"type":"number"},"competence5Comment":{"type":"string","nullable":true},"overallScore":{"type":"number"},"overallComment":{"type":"string","nullable":true},"isScoreZeroed":{"type":"boolean"},"preliminaryCheckComment":{"type":"string","nullable":true},"grammarFeedback":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"shortMessage":{"type":"string"},"replacements":{"type":"array","items":{"type":"string"}},"offset":{"type":"number"},"length":{"type":"number"},"type":{"type":"string","enum":["ortografia","concordancia","pontuacao","regencia","estilo"]}},"required":["message","shortMessage","replacements","offset","length","type"]}}},"required":["competence1Score","competence1Comment","competence2Score","competence2Comment","competence3Score","competence3Comment","competence4Score","competence4Comment","competence5Score","competence5Comment","overallScore","overallComment","isScoreZeroed","preliminaryCheckComment","grammarFeedback"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","title","content","contentWithGrammarFeedback","proposedTheme","motivationalTexts","userId","externalId","status","processStatus","processErrorMessage","correctionModel","enemFeedback","createdAt","updatedAt"]}}}},"400":{"description":"Dados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"API key ausente ou inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Módulo não permitido para esta chave/instituição","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Redação não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Erro interno"}}}}}}