ADA.fru.io API

# Basic structural remediation
curl -X POST https://ada.fru.io/api/v1/remediate \
  -H "X-API-Key: $ADA_API_KEY" \
  -F "[email protected]" \
  -o remediated-report.pdf

# Full AI remediation
curl -X POST https://ada.fru.io/api/v1/remediate \
  -H "X-API-Key: $ADA_API_KEY" \
  -F "[email protected]" \
  -F "includeAI=true" \
  -F "title=Annual Report 2025" \
  -o remediated-report.pdf

# Check compliance score from response headers
curl -X POST https://ada.fru.io/api/v1/remediate \
  -H "X-API-Key: $ADA_API_KEY" \
  -F "[email protected]" \
  -o remediated-report.pdf \
  -D - 2>/dev/null | grep "X-Compliance-Score"

import requests
import os

API_KEY = os.environ["ADA_API_KEY"]
BASE_URL = "https://ada.fru.io"

def remediate_pdf(input_path, output_path, include_ai=False):
    """Remediate a PDF and save the accessible version."""
    with open(input_path, "rb") as f:
        response = requests.post(
            f"{BASE_URL}/api/v1/remediate",
            headers={"X-API-Key": API_KEY},
            files={"file": (os.path.basename(input_path), f, "application/pdf")},
            data={"includeAI": "true" if include_ai else "false"},
        )

    response.raise_for_status()

    with open(output_path, "wb") as out:
        out.write(response.content)

    # Access remediation metadata from headers
    score = response.headers.get("X-Compliance-Score")
    issues = response.headers.get("X-Issues-Fixed-PDFUA")
    pages = response.headers.get("X-Pages-Processed")

    print(f"Score: {score}, Issues fixed: {issues}, Pages: {pages}")
    return response.headers


# Usage
remediate_pdf("report.pdf", "report-accessible.pdf")
remediate_pdf("brochure.pdf", "brochure-accessible.pdf", include_ai=True)

import fs from 'fs';
import path from 'path';

const API_KEY = process.env.ADA_API_KEY;
const BASE_URL = 'https://ada.fru.io';

async function remediatePdf(inputPath, outputPath, includeAI = false) {
  const formData = new FormData();
  const file = new Blob([fs.readFileSync(inputPath)], {
    type: 'application/pdf',
  });
  formData.append('file', file, path.basename(inputPath));
  formData.append('includeAI', String(includeAI));

  const response = await fetch(`${BASE_URL}/api/v1/remediate`, {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY },
    body: formData,
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`${error.error}: ${error.message}`);
  }

  const buffer = Buffer.from(await response.arrayBuffer());
  fs.writeFileSync(outputPath, buffer);

  console.log('Score:', response.headers.get('X-Compliance-Score'));
  console.log('Issues fixed:', response.headers.get('X-Issues-Fixed-PDFUA'));

  return Object.fromEntries(response.headers);
}

// Usage
await remediatePdf('report.pdf', 'report-accessible.pdf');

<?php
$apiKey = getenv('ADA_API_KEY');
$baseUrl = 'https://ada.fru.io';

function remediatePdf($inputPath, $outputPath, $includeAI = false) {
    global $apiKey, $baseUrl;

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => "$baseUrl/api/v1/remediate",
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HEADER => true,
        CURLOPT_HTTPHEADER => ["X-API-Key: $apiKey"],
        CURLOPT_POSTFIELDS => [
            'file' => new CURLFile($inputPath, 'application/pdf'),
            'includeAI' => $includeAI ? 'true' : 'false',
        ],
    ]);

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

    if ($httpCode !== 200) {
        throw new Exception("API error: HTTP $httpCode");
    }

    $headers = substr($response, 0, $headerSize);
    $body = substr($response, $headerSize);

    file_put_contents($outputPath, $body);

    // Parse compliance score from headers
    preg_match('/X-Compliance-Score: (\S+)/', $headers, $matches);
    echo "Compliance Score: " . ($matches[1] ?? 'N/A') . "\n";
}

// Usage
remediatePdf('report.pdf', 'report-accessible.pdf');
remediatePdf('brochure.pdf', 'brochure-accessible.pdf', true);

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("ADA_API_KEY"));

using var content = new MultipartFormDataContent();
using var fileStream = File.OpenRead("report.pdf");
content.Add(new StreamContent(fileStream), "file", "report.pdf");
content.Add(new StringContent("false"), "includeAI");

var response = await client.PostAsync(
    "https://ada.fru.io/api/v1/remediate", content);
response.EnsureSuccessStatusCode();

var pdfBytes = await response.Content.ReadAsByteArrayAsync();
await File.WriteAllBytesAsync("report-accessible.pdf", pdfBytes);

var score = response.Headers.GetValues("X-Compliance-Score").First();
Console.WriteLine($"Compliance Score: {score}");