Skill Proficiency Analysis API

import os
import requests

API_KEY = os.environ["OPENKNOWRA_API_KEY"]
API_URL = "https://platform.openknowra.ai/api/bff/v1/skill-proficiency/assess"

def analyse_resume(file_path: str) -> dict:
    with open(file_path, "rb") as f:
        res = requests.post(
            API_URL,
            headers={"Authorization": f"Bearer {API_KEY}"},
            files={"files": f},
        )
    if res.status_code == 402:
        err = res.json()["error"]
        raise ValueError(
            f"Insufficient credits: need {err['required']}, have {err['balance']}"
        )
    res.raise_for_status()
    return res.json()

result = analyse_resume("./candidate.pdf")
for band in result["bands"]:
    if band["skills"]:
        print(f"{band['level']} {band['label']}: {', '.join(band['skills'])}")

import fs from "fs";

const API_KEY = process.env.OPENKNOWRA_API_KEY!;
const API_URL = "https://platform.openknowra.ai/api/bff/v1/skill-proficiency/assess";

async function analyseResume(filePath: string) {
  const form = new FormData();
  const buffer = fs.readFileSync(filePath);
  form.append("files", new Blob([buffer]), "resume.pdf");

  const res = await fetch(API_URL, {
    method: "POST",
    headers: { Authorization: `Bearer ${API_KEY}` },
    body: form,
  });

  if (res.status === 402) {
    const err = await res.json() as { error: { required: number; balance: number } };
    throw new Error(
      `Insufficient credits: need ${err.error.required}, have ${err.error.balance}`
    );
  }

  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

const result = await analyseResume("./candidate.pdf");
console.log(JSON.stringify(result.bands, null, 2));