Salta al contingut
AIM PAPYREntraMenú
ES, EN, CA, EU, GL

API d'AIM PAPYR: licitacions i documents per HTTP

Les licitacions obertes i les eines de documents d'AIM PAPYR, des del teu codi. La cerca de licitacions respon ara mateix, sense clau; els documents, amb la clau del teu compte.

Prova-ho ara, sense clau

Les licitacions en termini que encaixen amb la teva cerca, amb el seu import, el seu termini i l'enllaç a l'anunci oficial.

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

Filtres: q (paraules), donde (província o codi NUTS), tipo, importe_min, importe_max, cierra_en_dias, orden (cierre, importe o cerca) i pagina (20 per pàgina). Una licitació: /v1/licitaciones/ficha?id=…

Què retorna

La forma de la resposta, retallada; els valors són de farciment. «contenido_de_la_plataforma» és el que publiquen els òrgans, tal qual.

{
  "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ímit d'ús: 60 peticions per minut i 1.000 per hora, per adreça IP. Si el superes, la resposta és 429 amb la capçalera Retry-After.

Origen de les dades: Ministerio de Hacienda (Plataforma de Contratación del Sector Público). El que mana és l'anunci oficial de cada licitació.

Amb clau: documents per HTTP (beta tancada)

Uneix, comprimeix i converteix documents amb la clau del teu compte. Està en beta tancada: requereix un pla de pagament i va inclosa als plans Plus i Pro, amb límit de ràfega, quota mensual i límits d'entrada. Per a més volum o una integració a mida, escriu-nos.

Crear la meva clau

Autenticació

Cada petició porta la teva clau a la capçalera. Crea-la al teu compte: es mostra una sola vegada, així que desa-la en un gestor de secrets. Pots revocar-la en qualsevol moment.

Authorization: Bearer papyr_sk_…

La teva primera crida amb clau

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

Escanejar a PDF en què es pot cercar

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

Extreure taules 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 des del 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 la teva clau i retorna el pla, el consum i els límits.
POST/api/v1/convert/to-pdfOffice → PDF — file
POST/api/v1/img/compressComprimir imatge — file + quality
POST/api/v1/img/convertConvertir imatge — 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-numbersNumerar — file + position, start
POST/api/v1/pdf/protectProtegir — file + password
POST/api/v1/pdf/rotateGirar — 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 → imatges — file + dpi, fmt
POST/api/v1/pdf/to-textPDF → Text — file
POST/api/v1/pdf/to-wordPDF → Word — file + lang
POST/api/v1/pdf/unlockDesbloquejar — file + password
POST/api/v1/pdf/watermarkMarca d'aigua — file + text

Límits

Errors

Tota resposta d'error de l'API porta el mateix cos: «error» (un codi estable), «detail» (el motiu, amb paraules), «que_hacer» (la sortida) i «ayuda» (aquesta taula). El codi HTTP no canvia.

Errors
HTTPerrorQuanQuè fer
401clave_ausenteLa petició no porta la capçalera Authorization.Envia la teva clau a la capçalera Authorization: Bearer papyr_sk_… Crea-la a https://www.aim-papyr.ai/ca/account.
401clave_no_validaLa clau no existeix o està revocada.Crea una clau nova a https://www.aim-papyr.ai/ca/account i torna-la a enviar. Una clau revocada deixa de valer.
403sin_planEl compte d'aquesta clau no té un pla de pagament.L'API de documents va inclosa als plans Plus i Pro. Mira els plans a https://www.aim-papyr.ai/ca/pricing.
404licitacion_no_encontradaL'«id» no és a la còpia de la Plataforma.Cerca-la amb https://www.aim-papyr.ai/v1/licitaciones/buscar i fes servir l'«id» que retorna.
404no_encontradoLa ruta no existeix.Aquesta adreça no existeix a l'API. Les rutes disponibles són a https://www.aim-papyr.ai/ca/api.
413archivo_grandeEl fitxer passa del límit de mida.Envia un fitxer més petit (el màxim és a https://www.aim-papyr.ai/ca/api#limites) o divideix-lo abans.
422datos_no_validosFalta un camp o no té el format esperat.Revisa el camp que diu «detail» i torna a enviar la petició. Els camps i els seus formats són a https://www.aim-papyr.ai/ca/api.
422filtro_no_validoUn filtre de la cerca (import, dies, km, municipi) no té el format esperat.El filtre «importe_min» espera un import en euros sense IVA, només xifres (per exemple 50000). Corregeix-lo o treu-lo i torna a enviar la petició; els filtres són a https://www.aim-papyr.ai/ca/api.
429demasiadas_peticionesHas passat el límit de ràfega o d'ús per hora.Espera els segons que indica la capçalera Retry-After i repeteix la petició.
424pliego_no_disponibleEl plec no s'ha pogut baixar de la Plataforma (l'ha rebutjat o no ha contestat).Descarrega el PDF del plec a la seva pàgina oficial i puja'l a la fitxa de la licitació (amb el teu compte, «Puja el PDF»); després repeteix aquesta petició. També pots repetir-la passats uns minuts.
429cuota_agotadaLa quota mensual del compte s'ha esgotat.La quota es renova el dia 1. Si necessites més volum, mira els plans a https://www.aim-papyr.ai/ca/pricing.
500error_internoAlguna cosa ha fallat per la nostra banda.Repeteix la petició d'aquí a uns segons. Si continua igual, escriu-nos a https://www.aim-papyr.ai/ca/contacte amb l'hora i la ruta.

Un exemple:

{
  "error": "clave_ausente",
  "detail": "Falta la capçalera Authorization: Bearer papyr_sk_…",
  "que_hacer": "Envia la teva clau a la capçalera Authorization: Bearer papyr_sk_… Crea-la a https://www.aim-papyr.ai/ca/account.",
  "ayuda": "https://www.aim-papyr.ai/ca/api#errores"
}

On es processen les teves dades

Es processa en servidors de la UE (Països Baixos) només per a la teva operació i es descarta amb la resposta. L'API segueix la mateixa política de privacitat que el web.

Per a desenvolupadors   Integració a mida, marca blanca o més volum? Parla amb nosaltres   Pricing