Daily answer-writing practice

curl https://api.evalezy.com/v1/exams \
  -H "X-API-Key: $EVALEZY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: daily-2026-10-02-gs2" \
  -d '{
    "title": "Daily Answer Writing, 2 Oct 2026: GS Paper II",
    "mode": "handwritten",
    "external_ref": "daily-2026-10-02-gs2",
    "subject": "GS Paper II: Polity and Governance",
    "level": "upsc",
    "instructions": "Answer in about 150 words. Use headings or a flow chart where useful.",
    "open": true,
    "questions": [
      {
        "label": "1",
        "type": "long_answer",
        "text": "Discuss the role of the Inter-State Council in strengthening cooperative federalism in India. (10 marks, 150 words)",
        "max_marks": 10,
        "word_limit": 150,
        "model_answer": "Introduction: Article 263 lets the President set up an Inter-State Council; it was constituted in 1990 on the Sarkaria Commission's recommendation. Body: forum for Centre-state and inter-state dialogue; recommendations on policy coordination; examples of the issues it has taken up; limitations: advisory role, infrequent meetings, no permanent secretariat strength. Way forward: regular meetings as recommended by the Punchhi Commission, a standing committee with follow-up on decisions. Conclusion: a revitalised Council can institutionalise cooperative federalism.",
        "rubric": {
          "partial_marking": true,
          "instructions": "Judge content first, then structure. Reward specific constitutional and commission references.",
          "criteria": [
            { "name": "Introduction and constitutional basis", "marks": 2, "keywords": ["Article 263", "Sarkaria"], "guidance": "Defines the Council and cites Article 263." },
            { "name": "Role in cooperative federalism", "marks": 4, "guidance": "Explains functions with at least two concrete examples." },
            { "name": "Limitations", "marks": 2, "guidance": "Identifies at least two weaknesses of the Council." },
            { "name": "Way forward and conclusion", "marks": 2, "guidance": "Gives reforms (for example the Punchhi Commission) and a balanced conclusion." }
          ]
        }
      }
    ]
  }'

from datetime import date

def create_daily_exam(day: date, question):
    ref = f"daily-{day.isoformat()}-{question.paper}"
    resp = requests.post(
        f"{API}/exams",
        json={
            "title": f"Daily Answer Writing, {day:%d %b %Y}: {question.paper_name}",
            "mode": "handwritten",
            "external_ref": ref,
            "subject": question.paper_name,
            "level": "upsc",
            "open": True,
            "questions": [{
                "label": "1",
                "type": "long_answer",
                "text": question.text,
                "max_marks": question.marks,          # 10 or 15
                "word_limit": question.word_limit,    # 150 or 250
                "model_answer": question.model_answer,
                "rubric": question.rubric,
            }],
        },
        headers={**HEADERS, "Idempotency-Key": ref},
        timeout=30,
    )
    body = resp.json()
    if resp.status_code == 409 and body["error"]["code"] == "exam_exists":
        return body["error"]["details"]["exam_id"]   # already created today
    resp.raise_for_status()
    return body["id"]

async function createDailyExam(day, q) {
  const ref = `daily-${day}-${q.paper}`;
  const res = await fetch(`${API}/exams`, {
    method: "POST",
    headers: { ...headers, "Idempotency-Key": ref },
    body: JSON.stringify({
      title: `Daily Answer Writing, ${day}: ${q.paperName}`,
      mode: "handwritten",
      external_ref: ref,
      subject: q.paperName,
      level: "upsc",
      open: true,
      questions: [{
        label: "1",
        type: "long_answer",
        text: q.text,
        max_marks: q.marks,
        word_limit: q.wordLimit,
        model_answer: q.modelAnswer,
        rubric: q.rubric,
      }],
    }),
  });
  const body = await res.json();
  if (res.status === 409 && body.error.code === "exam_exists") return body.error.details.exam_id;
  if (!res.ok) throw new Error(body.error.code);
  return body.id;
}

def submit_answer(exam_id, user, pdf_bytes, answer_id):
    # 1. Ask for an upload URL
    up = requests.post(
        f"{API}/uploads",
        json={"filename": f"{answer_id}.pdf", "content_type": "application/pdf",
              "size_bytes": len(pdf_bytes)},
        headers=HEADERS, timeout=30,
    )
    up.raise_for_status()
    upload = up.json()["uploads"][0]

    # 2. PUT the file
    requests.put(upload["upload_url"], data=pdf_bytes,
                 headers=upload.get("headers") or {"Content-Type": "application/pdf"},
                 timeout=120).raise_for_status()

    # 3. Submit it for the student
    resp = requests.post(
        f"{API}/exams/{exam_id}/submissions",
        json={
            "candidate": {"external_id": user.id, "name": user.display_name},
            "upload_id": upload["id"],
            "metadata": {"answer_id": answer_id},
        },
        headers={**HEADERS, "Idempotency-Key": f"answer-{answer_id}"},
        timeout=30,
    )
    body = resp.json()
    if resp.status_code == 409 and body["error"]["code"] == "submission_exists":
        raise AlreadySubmitted(body["error"]["details"]["submission_id"])
    resp.raise_for_status()
    return body   # status "queued", quote {"unit": "page", "pages": 3, "credits": 3, ...}

async function submitAnswer(examId, user, pdf, answerId) {
  const { uploads: [upload] } = await (await fetch(`${API}/uploads`, {
    method: "POST",
    headers,
    body: JSON.stringify({ filename: `${answerId}.pdf`, content_type: "application/pdf", size_bytes: pdf.length }),
  })).json();

  const put = await fetch(upload.upload_url, {
    method: upload.method ?? "PUT",
    headers: upload.headers ?? { "Content-Type": "application/pdf" },
    body: pdf,
  });
  if (!put.ok) throw new Error(`upload failed: ${put.status}`);

  const res = await fetch(`${API}/exams/${examId}/submissions`, {
    method: "POST",
    headers: { ...headers, "Idempotency-Key": `answer-${answerId}` },
    body: JSON.stringify({
      candidate: { external_id: user.id, name: user.displayName },
      upload_id: upload.id,
      metadata: { answer_id: answerId },
    }),
  });
  return res.json(); // 202 Accepted
}