Juniob Partner API

Authorization: Bearer <your-signed-jwt>

const jwt = require("jsonwebtoken");

const token = jwt.sign(
  {
    org: "acme-corp",
    developerEmail: "[email protected]",
    externalUserId: "recruiter-42",
  },
  process.env.JUNIOB_PARTNER_SECRET,
  { expiresIn: "10m" }
);

import jwt from "jsonwebtoken";

const BASE   = "https://api.juniob.io/partner";
const ORG    = process.env.JUNIOB_ORG;
const SECRET = process.env.JUNIOB_PARTNER_SECRET;

function signToken(developerEmail, externalUserId) {
  return jwt.sign(
    { org: ORG, developerEmail, externalUserId },
    SECRET,
    { expiresIn: "10m" }
  );
}

// ── Pull a selective report ──────────────────────────────────────────────────
async function getDeveloperReport(developerEmail, recruiterId, sections = []) {
  const token  = signToken(developerEmail, recruiterId);
  const params = sections.length ? `?sections=${sections.join(",")}` : "";

  const res = await fetch(`${BASE}/developer${params}`, {
    headers: { Authorization: `Bearer ${token}` },
  });

  if (res.status === 204) return null; // developer not in Juniob

  return res.json(); // { status, profile?, summary?, ... }
}

// ── Generate a recruiter view URL ────────────────────────────────────────────
async function getViewUrl(developerEmail, recruiterId) {
  const token = signToken(developerEmail, recruiterId);

  const res = await fetch(`${BASE}/generate-redirection-url`, {
    headers: { Authorization: `Bearer ${token}` },
  });

  return res.json(); // "https://juniob.io/partner/view?accessViewToken=..."
}

// Usage
const report = await getDeveloperReport(
  "[email protected]",
  "recruiter-42",
  ["profile", "summary", "risk"]
);

if (report?.status === "ASSESSED") {
  console.log(report.summary.recommendation);    // "SAFE_TO_INTERVIEW"
  console.log(report.summary.overallScore);      // 74
  console.log(report.risk.redFlags);             // []
}

import os
import jwt
import requests
from datetime import datetime, timedelta, timezone

BASE   = "https://api.juniob.io/partner"
ORG    = os.environ["JUNIOB_ORG"]
SECRET = os.environ["JUNIOB_PARTNER_SECRET"]


def sign_token(developer_email: str, external_user_id: str) -> str:
    payload = {
        "org":            ORG,
        "developerEmail": developer_email,
        "externalUserId": external_user_id,
        "exp":            datetime.now(timezone.utc) + timedelta(minutes=10),
    }
    return jwt.encode(payload, SECRET, algorithm="HS256")


def get_developer_report(
    developer_email: str,
    recruiter_id: str,
    sections: list[str] = [],
) -> dict | None:
    token  = sign_token(developer_email, recruiter_id)
    params = {"sections": ",".join(sections)} if sections else {}

    resp = requests.get(
        f"{BASE}/developer",
        headers={"Authorization": f"Bearer {token}"},
        params=params,
    )

    if resp.status_code == 204:
        return None  # developer not in Juniob

    resp.raise_for_status()
    return resp.json()


def get_view_url(developer_email: str, recruiter_id: str) -> str:
    token = sign_token(developer_email, recruiter_id)

    resp = requests.get(
        f"{BASE}/generate-redirection-url",
        headers={"Authorization": f"Bearer {token}"},
    )
    resp.raise_for_status()
    return resp.json()


# Usage
report = get_developer_report(
    "[email protected]",
    "recruiter-42",
    ["profile", "summary", "risk"],
)

if report and report["status"] == "ASSESSED":
    print(report["summary"]["recommendation"])  # "SAFE_TO_INTERVIEW"
    print(report["summary"]["overallScore"])    # 74
    print(report["risk"]["redFlags"])           # []