Documentación

El contrato de integración

De la clave API al PDF/UA en tres pasos previsibles

Una URL base, una cabecera de autenticación y un ID de caso conectan todo el flujo.

1. 01POST/pdf/upload

   Subir

   Envía uno o varios PDF y recibe un caseId por cada archivo aceptado.

   Abrir la documentación del endpoint
2. 02GET/job-status/{caseId}

   Seguir

   Consulta un ciclo claro desde queued y running hasta un estado final.

   Abrir la documentación del endpoint
3. 03GET/download/{caseId}

   Descargar

   Obtén el documento corregido como una respuesta application/pdf estándar.

   Abrir la documentación del endpoint

Copia, ejecuta, integra

Tu primera subida está lista para ejecutar

Elige tu stack. Cada ejemplo llama al mismo endpoint y devuelve el ID de caso que usa el resto de la API.

• Define ACCESSFUL_API_KEY
• Coloca document.pdf en el directorio de trabajo
• Ejecuta el ejemplo y guarda successfulUploads[0]

Continuar con el inicio rápido completo

first-upload API

cURLNode.jsPython

: "${ACCESSFUL_API_KEY:?Set ACCESSFUL_API_KEY first}"

curl --fail-with-body \
  -X POST "https://api.accessful.de/api/v1/upload-service/pdf/upload" \
  -H "X-API-Key: $ACCESSFUL_API_KEY" \
  -F "files=@document.pdf"

import { openAsBlob } from 'node:fs';

const apiKey = process.env.ACCESSFUL_API_KEY;
if (!apiKey) throw new Error('Set ACCESSFUL_API_KEY first');

const file = await openAsBlob('document.pdf', {
  type: 'application/pdf',
});
const body = new FormData();
body.append('files', file, 'document.pdf');

const response = await fetch(
  'https://api.accessful.de/api/v1/upload-service/pdf/upload',
  {
    method: 'POST',
    headers: { 'X-API-Key': apiKey },
    body,
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

# pip install requests
import os
import requests

url = "https://api.accessful.de/api/v1/upload-service/pdf/upload"
headers = {"X-API-Key": os.environ["ACCESSFUL_API_KEY"]}

with open("document.pdf", "rb") as pdf:
    response = requests.post(
        url,
        headers=headers,
        files={"files": ("document.pdf", pdf, "application/pdf")},
        timeout=60,
    )

response.raise_for_status()
print(response.json())

200 OKsuccessfulUploads[0] → caseId

Elige el siguiente paso

De la primera petición a producción sin perder tiempo buscando

Cada ruta empieza donde estás y te lleva directamente al detalle que necesitas.

Inicio rápido

Ejecuta subir → estado → descargar de principio a fin.

Abrir inicio rápido

Probador de API

Convierte un PDF real en el navegador con tu propia clave.

Probar en vivo

Referencia API

Consulta cada endpoint, campo, respuesta y código de estado.

Ver endpoints

Webhooks

Sustituye el sondeo por callbacks firmados y orientados a eventos.

Configurar webhooks

Documentación para agentes

¿Desarrollas con un agente de programación con IA?

Instala el skill versionado de Accessful para que tu agente comprenda todo el contrato de la API sin hacer suposiciones.

Descargar el skill del agente