3pap Intelligence API

<?php
$API_BASE = "http://checker.3pap.africa/api/v1";
$API_TOKEN = "3pap_your_token_here";

function apiRequest($method, $url, $data = null, $isFile = false) {
    global $API_BASE, $API_TOKEN;

    $ch = curl_init($API_BASE . $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: Bearer " . $API_TOKEN,
    ]);

    if ($method === "POST") {
        curl_setopt($ch, CURLOPT_POST, true);
        if ($isFile) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        } else {
            curl_setopt($ch, CURLOPT_HTTPHEADER, [
                "Authorization: Bearer " . $API_TOKEN,
                "Content-Type: application/json",
            ]);
            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        }
    } elseif ($method === "DELETE") {
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
    }

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    return ["code" => $httpCode, "body" => json_decode($response, true)];
}

// ─── 1. Analyze a CV ───────────────────────────────────────────
$cvFile = new CURLFile("/path/to/resume.pdf", "application/pdf", "resume.pdf");
$result = apiRequest("POST", "/cv/analyze", [
    "cv_file" => $cvFile,
    "department" => "Engineering",
    "position" => "Senior Developer",
    "reference_id" => "APP-2026-0042",
    "auto_sanctions_check" => "true",
], true);

$profile = $result["body"]["profile"];
echo "Profile ID: " . $profile["id"] . "\n";
echo "Name: " . $profile["name"] . "\n";
echo "Sanctioned: " . ($profile["is_sanctioned"] ? "YES" : "NO") . "\n";

// ─── 2. Get Full Report ───────────────────────────────────────
$report = apiRequest("GET", "/cv/profiles/" . $profile["id"] . "/report");
$summary = $report["body"]["report"]["report_summary"];
echo "Skills: " . $summary["total_skills"] . "\n";

// ─── 3. Screen a Company ──────────────────────────────────────
$screening = apiRequest("POST", "/sanctions/screen", [
    "name" => "Acme Corporation",
    "country" => "Nigeria",
]);
echo "Risk Level: " . $screening["body"]["risk_level"] . "\n";

// ─── 4. Batch Screen ─────────────────────────────────────────
$batch = apiRequest("POST", "/sanctions/batch", [
    "entities" => [
        ["name" => "Vendor A Ltd", "country" => "South Africa"],
        ["name" => "Supplier B Inc", "country" => "Ghana"],
    ],
]);
echo "Flagged: " . $batch["body"]["total_flagged"] . "\n";

// ─── 5. Check Usage ──────────────────────────────────────────
$usage = apiRequest("GET", "/usage");
foreach ($usage["body"]["usage"] as $action => $data) {
    echo "$action: {$data['used']}/{$data['limit']}\n";
}
?>

const fs = require("fs");
const FormData = require("form-data");

const API_BASE = "http://checker.3pap.africa/api/v1";
const API_TOKEN = "3pap_your_token_here";

const headers = { Authorization: `Bearer ${API_TOKEN}` };

async function apiRequest(method, path, body = null, isForm = false) {
  const url = `${API_BASE}${path}`;
  const opts = { method, headers: { ...headers } };

  if (body && isForm) {
    opts.body = body;
    Object.assign(opts.headers, body.getHeaders());
  } else if (body) {
    opts.headers["Content-Type"] = "application/json";
    opts.body = JSON.stringify(body);
  }

  const resp = await fetch(url, opts);
  return resp.json();
}

// ─── 1. Analyze a CV ───────────────────────────────────────────
const form = new FormData();
form.append("cv_file", fs.createReadStream("resume.pdf"));
form.append("department", "Engineering");
form.append("position", "Senior Developer");
form.append("reference_id", "APP-2026-0042");
form.append("auto_sanctions_check", "true");

const analyzeResult = await apiRequest("POST", "/cv/analyze", form, true);
const profile = analyzeResult.profile;
console.log(`Profile ID: ${profile.id}`);
console.log(`Name: ${profile.name}`);
console.log(`Skills: ${profile.skills.map((s) => s.name).join(", ")}`);
console.log(`Sanctioned: ${profile.is_sanctioned}`);

// ─── 2. Get Full Report ───────────────────────────────────────
const report = await apiRequest("GET", `/cv/profiles/${profile.id}/report`);
console.log(`Health Score: ${report.report.career_analysis?.health_score}`);

// ─── 3. Screen a Company ──────────────────────────────────────
const screening = await apiRequest("POST", "/sanctions/screen", {
  name: "Acme Corporation",
  country: "Nigeria",
});
console.log(`Risk: ${screening.risk_level}, Matches: ${screening.total_matches}`);

// ─── 4. Batch Screen ─────────────────────────────────────────
const batch = await apiRequest("POST", "/sanctions/batch", {
  entities: [
    { name: "Vendor A Ltd", country: "South Africa" },
    { name: "Supplier B Inc", country: "Ghana" },
  ],
});
console.log(`Screened: ${batch.total_screened}, Flagged: ${batch.total_flagged}`);

// ─── 5. Check Usage ──────────────────────────────────────────
const usage = await apiRequest("GET", "/usage");
Object.entries(usage.usage).forEach(([action, data]) => {
  console.log(`${action}: ${data.used}/${data.limit}`);
});

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;

class ThreePapClient
{
    private readonly HttpClient _client;
    private const string ApiBase = "http://checker.3pap.africa/api/v1";

    public ThreePapClient(string apiToken)
    {
        _client = new HttpClient();
        _client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", apiToken);
    }

    // ─── 1. Analyze a CV ───────────────────────────────────────
    public async Task<JsonElement> AnalyzeCV(string filePath,
        string department = "", string position = "", string referenceId = "")
    {
        using var form = new MultipartFormDataContent();
        var fileStream = File.OpenRead(filePath);
        form.Add(new StreamContent(fileStream), "cv_file",
            Path.GetFileName(filePath));
        if (!string.IsNullOrEmpty(department))
            form.Add(new StringContent(department), "department");
        if (!string.IsNullOrEmpty(position))
            form.Add(new StringContent(position), "position");
        if (!string.IsNullOrEmpty(referenceId))
            form.Add(new StringContent(referenceId), "reference_id");
        form.Add(new StringContent("true"), "auto_sanctions_check");

        var resp = await _client.PostAsync($"{ApiBase}/cv/analyze", form);
        var json = await resp.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json).RootElement;
    }

    // ─── 2. Get Full Report ───────────────────────────────────
    public async Task<JsonElement> GetReport(int profileId)
    {
        var resp = await _client.GetAsync(
            $"{ApiBase}/cv/profiles/{profileId}/report");
        var json = await resp.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json).RootElement;
    }

    // ─── 3. Screen Entity ─────────────────────────────────────
    public async Task<JsonElement> ScreenEntity(string name,
        string country = "")
    {
        var body = new { name, country };
        var content = new StringContent(
            JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
        var resp = await _client.PostAsync(
            $"{ApiBase}/sanctions/screen", content);
        var json = await resp.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json).RootElement;
    }

    // ─── 4. Batch Screen ──────────────────────────────────────
    public async Task<JsonElement> BatchScreen(
        List<Dictionary<string, string>> entities)
    {
        var body = new { entities };
        var content = new StringContent(
            JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
        var resp = await _client.PostAsync(
            $"{ApiBase}/sanctions/batch", content);
        var json = await resp.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json).RootElement;
    }

    // ─── 5. Check Usage ───────────────────────────────────────
    public async Task<JsonElement> GetUsage()
    {
        var resp = await _client.GetAsync($"{ApiBase}/usage");
        var json = await resp.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json).RootElement;
    }
}

// Usage:
var client = new ThreePapClient("3pap_your_token_here");
var result = await client.AnalyzeCV("resume.pdf",
    department: "Engineering", position: "Senior Dev");
Console.WriteLine($"Profile: {result.GetProperty("profile").GetProperty("name")}");

var screening = await client.ScreenEntity("Acme Corp", "Nigeria");
Console.WriteLine($"Risk: {screening.GetProperty("risk_level")}");

import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import com.google.gson.*;

public class ThreePapClient {
    private static final String API_BASE = "http://checker.3pap.africa/api/v1";
    private final HttpClient client;
    private final String token;

    public ThreePapClient(String apiToken) {
        this.client = HttpClient.newHttpClient();
        this.token = apiToken;
    }

    // ─── 1. Analyze a CV ───────────────────────────────────────
    public JsonObject analyzeCV(String filePath) throws Exception {
        String boundary = "----FormBoundary" + System.currentTimeMillis();
        byte[] fileBytes = Files.readAllBytes(Path.of(filePath));
        String fileName = Path.of(filePath).getFileName().toString();

        String body = "--" + boundary + "\r\n"
            + "Content-Disposition: form-data; name=\"cv_file\"; "
            + "filename=\"" + fileName + "\"\r\n"
            + "Content-Type: application/pdf\r\n\r\n";
        String end = "\r\n--" + boundary
            + "\r\nContent-Disposition: form-data; "
            + "name=\"auto_sanctions_check\"\r\n\r\ntrue\r\n"
            + "--" + boundary + "--\r\n";

        byte[] bodyBytes = concat(body.getBytes(), fileBytes, end.getBytes());

        HttpRequest req = HttpRequest.newBuilder()
            .uri(URI.create(API_BASE + "/cv/analyze"))
            .header("Authorization", "Bearer " + token)
            .header("Content-Type", "multipart/form-data; boundary=" + boundary)
            .POST(HttpRequest.BodyPublishers.ofByteArray(bodyBytes))
            .build();

        HttpResponse<String> resp = client.send(req,
            HttpResponse.BodyHandlers.ofString());
        return JsonParser.parseString(resp.body()).getAsJsonObject();
    }

    // ─── 2. Screen Entity ─────────────────────────────────────
    public JsonObject screenEntity(String name, String country)
        throws Exception {
        JsonObject body = new JsonObject();
        body.addProperty("name", name);
        if (country != null) body.addProperty("country", country);

        HttpRequest req = HttpRequest.newBuilder()
            .uri(URI.create(API_BASE + "/sanctions/screen"))
            .header("Authorization", "Bearer " + token)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body.toString()))
            .build();

        HttpResponse<String> resp = client.send(req,
            HttpResponse.BodyHandlers.ofString());
        return JsonParser.parseString(resp.body()).getAsJsonObject();
    }

    // ─── 3. Batch Screen ──────────────────────────────────────
    public JsonObject batchScreen(String[][] entities) throws Exception {
        JsonArray arr = new JsonArray();
        for (String[] e : entities) {
            JsonObject obj = new JsonObject();
            obj.addProperty("name", e[0]);
            if (e.length > 1) obj.addProperty("country", e[1]);
            arr.add(obj);
        }
        JsonObject body = new JsonObject();
        body.add("entities", arr);

        HttpRequest req = HttpRequest.newBuilder()
            .uri(URI.create(API_BASE + "/sanctions/batch"))
            .header("Authorization", "Bearer " + token)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body.toString()))
            .build();

        HttpResponse<String> resp = client.send(req,
            HttpResponse.BodyHandlers.ofString());
        return JsonParser.parseString(resp.body()).getAsJsonObject();
    }

    private static byte[] concat(byte[]... arrays) {
        int len = 0;
        for (byte[] a : arrays) len += a.length;
        byte[] result = new byte[len];
        int pos = 0;
        for (byte[] a : arrays) {
            System.arraycopy(a, 0, result, pos, a.length);
            pos += a.length;
        }
        return result;
    }

    // Usage
    public static void main(String[] args) throws Exception {
        var api = new ThreePapClient("3pap_your_token_here");
        var result = api.analyzeCV("resume.pdf");
        System.out.println("Name: " + result
            .getAsJsonObject("profile").get("name"));

        var screen = api.screenEntity("Acme Corp", "Nigeria");
        System.out.println("Risk: " + screen.get("risk_level"));
    }
}

// ─── api.js - API Client ──────────────────────────────────────
const API_BASE = "http://checker.3pap.africa/api/v1";

export async function apiRequest(method, path, body, isFormData = false) {
  const token = localStorage.getItem("threepap_api_token");
  const headers = { Authorization: `Bearer ${token}` };

  const opts = { method, headers };
  if (body && isFormData) {
    opts.body = body; // FormData sets its own Content-Type
  } else if (body) {
    headers["Content-Type"] = "application/json";
    opts.body = JSON.stringify(body);
  }

  const resp = await fetch(`${API_BASE}${path}`, opts);
  if (!resp.ok) {
    const err = await resp.json();
    throw new Error(err.error || "API request failed");
  }
  return resp.json();
}

// ─── CVUploader.jsx - Upload & Analyze CV ─────────────────────
import { useState } from "react";
import { apiRequest } from "./api";

export function CVUploader({ onAnalyzed }) {
  const [uploading, setUploading] = useState(false);
  const [error, setError] = useState(null);

  const handleUpload = async (e) => {
    e.preventDefault();
    setUploading(true);
    setError(null);

    const formData = new FormData(e.target);
    formData.append("auto_sanctions_check", "true");

    try {
      const result = await apiRequest(
        "POST", "/cv/analyze", formData, true
      );
      onAnalyzed(result.profile);
    } catch (err) {
      setError(err.message);
    } finally {
      setUploading(false);
    }
  };

  return (
    <form onSubmit={handleUpload}>
      <input type="file" name="cv_file" accept=".pdf,.docx,.png,.jpg,.jpeg,.tif,.tiff,.webp"
        required />
      <input type="text" name="department"
        placeholder="Department" />
      <input type="text" name="position"
        placeholder="Position" />
      <input type="text" name="reference_id"
        placeholder="Internal Reference ID" />
      <button type="submit" disabled={uploading}>
        {uploading ? "Analyzing..." : "Upload & Analyze"}
      </button>
      {error && <p className="error">{error}</p>}
    </form>
  );
}

// ─── SanctionsChecker.jsx - Screen Companies ──────────────────
export function SanctionsChecker() {
  const [name, setName] = useState("");
  const [result, setResult] = useState(null);
  const [loading, setLoading] = useState(false);

  const handleScreen = async () => {
    setLoading(true);
    try {
      const data = await apiRequest("POST", "/sanctions/screen",
        { name });
      setResult(data);
    } catch (err) {
      alert(err.message);
    } finally {
      setLoading(false);
    }
  };

  return (
    <div>
      <input value={name}
        onChange={(e) => setName(e.target.value)}
        placeholder="Company or person name" />
      <button onClick={handleScreen} disabled={loading}>
        {loading ? "Screening..." : "Screen"}
      </button>

      {result && (
        <div className={`risk-${result.risk_level}`}>
          <h3>Risk: {result.risk_level.toUpperCase()}</h3>
          <p>{result.total_matches} matches found</p>
          {result.results.map((entity) => (
            <div key={entity.id}>
              <strong>{entity.name}</strong>
              <span>{entity.dataset} - {entity.country}</span>
              <span>Score: {Math.round(entity.match_score*100)}%</span>
            </div>
          ))}
        </div>
      )}
    </div>
  );
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

const (
    apiBase  = "http://checker.3pap.africa/api/v1"
    apiToken = "3pap_your_token_here"
)

func apiGet(path string) (map[string]interface{}, error) {
    req, _ := http.NewRequest("GET", apiBase+path, nil)
    req.Header.Set("Authorization", "Bearer "+apiToken)
    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    return result, nil
}

func apiPostJSON(path string, data interface{}) (map[string]interface{}, error) {
    body, _ := json.Marshal(data)
    req, _ := http.NewRequest("POST", apiBase+path,
        bytes.NewBuffer(body))
    req.Header.Set("Authorization", "Bearer "+apiToken)
    req.Header.Set("Content-Type", "application/json")
    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    return result, nil
}

// ─── Analyze CV ──────────────────────────────────────────────
func analyzeCV(filePath string) (map[string]interface{}, error) {
    file, _ := os.Open(filePath)
    defer file.Close()

    var buf bytes.Buffer
    writer := multipart.NewWriter(&buf)
    part, _ := writer.CreateFormFile("cv_file", filePath)
    io.Copy(part, file)
    writer.WriteField("auto_sanctions_check", "true")
    writer.Close()

    req, _ := http.NewRequest("POST", apiBase+"/cv/analyze", &buf)
    req.Header.Set("Authorization", "Bearer "+apiToken)
    req.Header.Set("Content-Type", writer.FormDataContentType())

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    return result, nil
}

func main() {
    // Analyze CV
    result, _ := analyzeCV("resume.pdf")
    profile := result["profile"].(map[string]interface{})
    fmt.Printf("Name: %s\n", profile["name"])

    // Screen entity
    screening, _ := apiPostJSON("/sanctions/screen", map[string]string{
        "name":    "Acme Corporation",
        "country": "Nigeria",
    })
    fmt.Printf("Risk: %s\n", screening["risk_level"])

    // Check usage
    usage, _ := apiGet("/usage")
    fmt.Printf("Plan: %s\n", usage["plan"])
}

require 'net/http'
require 'json'
require 'uri'

API_BASE = "http://checker.3pap.africa/api/v1"
API_TOKEN = "3pap_your_token_here"

def api_get(path)
  uri = URI("#{API_BASE}#{path}")
  req = Net::HTTP::Get.new(uri)
  req["Authorization"] = "Bearer #{API_TOKEN}"
  resp = Net::HTTP.start(uri.hostname, uri.port,
    use_ssl: uri.scheme == "https") { |h| h.request(req) }
  JSON.parse(resp.body)
end

def api_post_json(path, data)
  uri = URI("#{API_BASE}#{path}")
  req = Net::HTTP::Post.new(uri)
  req["Authorization"] = "Bearer #{API_TOKEN}"
  req["Content-Type"] = "application/json"
  req.body = data.to_json
  resp = Net::HTTP.start(uri.hostname, uri.port,
    use_ssl: uri.scheme == "https") { |h| h.request(req) }
  JSON.parse(resp.body)
end

# ─── 1. Analyze a CV ───────────────────────────────────────────
uri = URI("#{API_BASE}/cv/analyze")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{API_TOKEN}"

form_data = [
  ["cv_file", File.open("resume.pdf"), {
    filename: "resume.pdf",
    content_type: "application/pdf"
  }],
  ["department", "Engineering"],
  ["auto_sanctions_check", "true"],
]
req.set_form(form_data, "multipart/form-data")

resp = Net::HTTP.start(uri.hostname, uri.port,
  use_ssl: uri.scheme == "https") { |h| h.request(req) }
result = JSON.parse(resp.body)
profile = result["profile"]
puts "Name: #{profile['name']}"
puts "Skills: #{profile['skills'].map { |s| s['name'] }.join(', ')}"

# ─── 2. Screen Entity ─────────────────────────────────────────
screening = api_post_json("/sanctions/screen", {
  name: "Acme Corporation",
  country: "Nigeria",
})
puts "Risk: #{screening['risk_level']}"
puts "Matches: #{screening['total_matches']}"

# ─── 3. Batch Screen ──────────────────────────────────────────
batch = api_post_json("/sanctions/batch", {
  entities: [
    { name: "Vendor A Ltd", country: "South Africa" },
    { name: "Supplier B Inc", country: "Ghana" },
  ],
})
puts "Flagged: #{batch['total_flagged']}/#{batch['total_screened']}"

# ─── 4. Check Usage ───────────────────────────────────────────
usage = api_get("/usage")
usage["usage"].each do |action, data|
  puts "#{action}: #{data['used']}/#{data['limit']}"
end