Font & license checks, wired straight into your pipeline

curl -X POST https://api.fontscanner.app/api/ci/scans/website \
  -H "X-API-Key: fsk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourdomain.com",
    "webhook": {
      "enabled": true,
      "url": "https://ci.example.com/fontscanner-callback",
      "headers": { "Authorization": "Bearer <your-ci-token>" }
    }
  }'

Your webhook handler model

// What we POST to your webhook URL — same JSON as GET /api/ci/jobs/{id}.
// Deserialize `result` as FontScannerScanResult when status is "Completed".

type FontScannerJob = {
  jobId: string;
  jobType: "website" | "pdf" | "image";
  status: "Queued" | "Processing" | "Completed" | "Failed" | "Cancelled";
  createdAt: string;          // ISO-8601
  completedAt: string | null;
  errorMessage: string | null;
  result: FontScannerScanResult | null;
};

type FontScannerScanResult = {
  jobId: string;
  domain: string;             // scanned host, PDF filename, or image filename
  status: "Completed";
  scanTime: string | null;    // when the job finished (ISO-8601)
  jobType: "website" | "pdf" | "image";
  matchedKnownFonts: {
    fontName: string;
    vendor: string;
    licenseType: string;      // e.g. "Commercial"
  }[];
  pages: FontScannerPage[];
};

type FontScannerPage = {
  id: string;
  url: string;
  status: string;
  scannedAt: string | null;
  fonts: FontScannerFont[];
};

type FontScannerFont = {
  fontName: string;
  fontFamily: string;
  sourceType: string;         // GoogleFonts | Typekit | SelfHosted | Pdf | Image | …
  sourceUrl: string | null;
  detectionContext: string | null;
  sourceSnippet: string | null;
  isLicensed: boolean;        // true → commercial license required
  isDeclaredCommercial: boolean;
  licenseName: string | null;
  licenseVendor: string | null;
  isIconFont: boolean;
  isUnverified: boolean;
  purchaseUrl: string | null;
  licensingHint: string | null;
  evidenceKind: string;
  licensingStatus: string;    // ActionRequired | OpenSource | ...
  distributesFontFile: boolean;
};