Saltar ao contido
AIM PAPYREntrarMenú
ES, EN, CA, EU, GL

API de AIM PAPYR: licitacións e documentos por HTTP

As licitacións abertas e as ferramentas de documentos de AIM PAPYR, desde o teu código. A busca de licitacións responde agora mesmo, sen clave; os documentos, coa clave da túa conta.

Proba agora, sen clave

As licitacións en prazo que encaixan coa túa busca, co seu importe, o seu prazo e a ligazón ao anuncio oficial.

curl "https://www.aim-papyr.ai/v1/licitaciones/buscar?q=limpieza"

Filtros: q (palabras), donde (provincia ou código NUTS), tipo, importe_min, importe_max, cierra_en_dias, orden (cierre, importe ou cerca) e pagina (20 por páxina). Unha licitación: /v1/licitaciones/ficha?id=…

Que devolve

A forma da resposta, recortada; os valores son de recheo. «contenido_de_la_plataforma» é o que publican os órganos, tal cal.

{
  "resumen": "…",
  "total": 0,
  "importe_total_sin_iva": 0,
  "pagina": 1,
  "paginas": 1,
  "filtros_aplicados": {"q": "limpieza"},
  "en_la_web": "https://www.aim-papyr.ai/licitaciones?q=limpieza#resultados",
  "contenido_de_la_plataforma": [
    {"id": "…", "titulo": "…", "organo": "…", "lugar": "…", "tipo": "…",
     "presupuesto_sin_iva": 0, "fin_presentacion": "…", "ficha": "…", "anuncio_oficial": "…"}
  ],
  "origen": "…"
}

Límite de uso: 60 peticións por minuto e 1.000 por hora, por enderezo IP. Se o superas, a resposta é 429 coa cabeceira Retry-After.

Orixe dos datos: Ministerio de Hacienda (Plataforma de Contratación del Sector Público). O que manda é o anuncio oficial de cada licitación.

Con clave: documentos por HTTP (beta pechada)

Une, comprime e converte documentos coa clave da túa conta. Está en beta pechada: require un plan de pago e vai incluída nos plans Plus e Pro, con límite de ráfaga, cota mensual e límites de entrada. Para máis volume ou unha integración a medida, escríbenos.

Crear a miña clave

Autenticación

Cada petición leva a túa clave na cabeceira. Créaa na túa conta: amósase unha soa vez, así que gárdaa nun xestor de segredos. Podes revogala en calquera momento.

Authorization: Bearer papyr_sk_…

A túa primeira chamada con clave

curl -X POST https://www.aim-papyr.ai/api/v1/pdf/merge \
  -H "Authorization: Bearer papyr_sk_YOUR_KEY" \
  -F "files=@report.pdf" -F "files=@annex.pdf" \
  -o merged.pdf

Escanear a PDF pesquisable

bash
curl -X POST https://www.aim-papyr.ai/api/v1/pdf/ocr \
  -H "Authorization: Bearer papyr_sk_YOUR_KEY" \
  -F "file=@factura.pdf" -F "lang=spa" \
  -o factura-buscable.pdf

Extraer táboas a CSV

python
import requests

r = requests.post(
    "https://www.aim-papyr.ai/api/v1/pdf/to-csv",
    headers={"Authorization": "Bearer papyr_sk_YOUR_KEY"},
    files={"file": open("facturas.pdf", "rb")},
    data={"sep": ";"}, timeout=120)
r.raise_for_status()
open("facturas.csv", "wb").write(r.content)
print(r.headers["X-Monthly-Used"], "/", r.headers["X-Monthly-Limit"])

PDF a Word desde o navegador

javascript
const fd = new FormData();
fd.append("file", archivo);        // File o Blob

const r = await fetch("https://www.aim-papyr.ai/api/v1/pdf/to-word", {
  method: "POST",
  headers: { Authorization: "Bearer papyr_sk_YOUR_KEY" },
  body: fd,
});
if (!r.ok) throw new Error((await r.json()).detail);
const docx = await r.blob();

Endpoints (v1)

Endpoints (v1)
GET/api/v1/meValida a túa clave; devolve o plan, o uso e os límites.
POST/api/v1/convert/to-pdfOffice → PDF — file
POST/api/v1/img/compressComprimir imaxe — file + quality
POST/api/v1/img/convertConverter imaxe — file + fmt, quality
POST/api/v1/pdf/compressComprimir — file
POST/api/v1/pdf/mergeUnir — files[]
POST/api/v1/pdf/ocrOCR — file + lang
POST/api/v1/pdf/page-numbersNúmeros de páxina — file + position, start
POST/api/v1/pdf/protectProtexer — file + password
POST/api/v1/pdf/rotateXirar — file + degrees
POST/api/v1/pdf/splitDividir — file + every/cada
POST/api/v1/pdf/to-csvPDF → CSV — file + sep
POST/api/v1/pdf/to-imagesPDF → imaxes — file + dpi, fmt
POST/api/v1/pdf/to-textPDF → Texto — file
POST/api/v1/pdf/to-wordPDF → Word — file + lang
POST/api/v1/pdf/unlockDesbloquear — file + password
POST/api/v1/pdf/watermarkMarca de auga — file + text

Límites

Erros

Toda resposta de erro da API leva o mesmo corpo: «error» (un código estable), «detail» (o motivo, con palabras), «que_hacer» (a saída) e «ayuda» (esta táboa). O código HTTP non cambia.

Erros
HTTPerrorCandoQue facer
401clave_ausenteA petición non leva a cabeceira Authorization.Envía a túa clave na cabeceira Authorization: Bearer papyr_sk_… Créaa en https://www.aim-papyr.ai/gl/account.
401clave_no_validaA clave non existe ou está revogada.Crea unha clave nova en https://www.aim-papyr.ai/gl/account e envíaa de novo. Unha clave revogada deixa de valer.
403sin_planA conta desa clave non ten un plan de pago.A API de documentos vai incluída nos plans Plus e Pro. Mira os plans en https://www.aim-papyr.ai/gl/pricing.
404licitacion_no_encontradaO «id» non está na copia da Plataforma.Búscaa con https://www.aim-papyr.ai/v1/licitaciones/buscar e usa o «id» que devolve.
404no_encontradoA ruta non existe.Esa dirección non existe na API. As rutas dispoñibles están en https://www.aim-papyr.ai/gl/api.
413archivo_grandeO ficheiro pasa do límite de tamaño.Envía un ficheiro máis pequeno (o máximo está en https://www.aim-papyr.ai/gl/api#limites) ou divídeo antes.
422datos_no_validosFalta un campo ou non ten o formato esperado.Revisa o campo que di «detail» e volve enviar a petición. Os campos e os seus formatos están en https://www.aim-papyr.ai/gl/api.
422filtro_no_validoUn filtro da busca (importe, días, km, concello) non ten o formato esperado.O filtro «importe_min» agarda un importe en euros sen IVE, só cifras (por exemplo 50000). Corríxeo ou quítao e volve enviar a petición; os filtros están en https://www.aim-papyr.ai/gl/api.
429demasiadas_peticionesPasaches o límite de ráfaga ou de uso por hora.Agarda os segundos que indica a cabeceira Retry-After e repite a petición.
424pliego_no_disponibleO prego non se puido baixar da Plataforma (rexeitouno ou non contestou).Descarga o PDF do prego na súa páxina oficial e súbeo na ficha da licitación (coa túa conta, «Sube o PDF»); despois repite esta petición. Tamén podes repetila pasados uns minutos.
429cuota_agotadaA cota mensual da conta esgotouse.A cota renóvase o día 1. Se precisas máis volume, mira os plans en https://www.aim-papyr.ai/gl/pricing.
500error_internoAlgo fallou da nosa banda.Repite a petición en uns segundos. Se segue igual, escríbenos a https://www.aim-papyr.ai/gl/contacto coa hora e a ruta.

Un exemplo:

{
  "error": "clave_ausente",
  "detail": "Falta a cabeceira Authorization: Bearer papyr_sk_…",
  "que_hacer": "Envía a túa clave na cabeceira Authorization: Bearer papyr_sk_… Créaa en https://www.aim-papyr.ai/gl/account.",
  "ayuda": "https://www.aim-papyr.ai/gl/api#errores"
}

Onde se procesan os teus datos

Procésase en servidores da UE (Países Baixos) só para a túa operación e descártase coa resposta. A API segue a mesma política de privacidade ca a web.

Para desenvolvedores   Integración a medida, marca branca ou máis volume? Fala connosco   Pricing