Joan edukira
AIM PAPYRSartuMenua
ES, EN, CA, EU, GL

AIM PAPYR APIa: lizitazioak eta dokumentuak HTTP bidez

AIM PAPYR-en lizitazio irekiak eta dokumentu-tresnak, zure kodetik. Lizitazioen bilaketak orain bertan erantzuten du, gakorik gabe; dokumentuek zure kontuko gakoa behar dute.

Probatu orain, gakorik gabe

Zure bilaketarekin bat datozen lizitazio irekiak, zenbatekoarekin, epearekin eta iragarki ofizialerako estekarekin.

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

Iragazkiak: q (hitzak), donde (probintzia edo NUTS kodea), tipo, importe_min, importe_max, cierra_en_dias, orden (cierre, importe edo cerca) eta pagina (20 orriko). Lizitazio bat: /v1/licitaciones/ficha?id=…

Zer itzultzen du

Erantzunaren forma, moztuta; hemengo balioak txantiloiak dira. «contenido_de_la_plataforma» organoek argitaratzen dutena da, hala-hala.

{
  "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": "…"
}

Erabilera-muga: 60 eskaera minutuko eta 1.000 orduko, IP helbide bakoitzeko. Gainditzen baduzu, erantzuna 429 da, Retry-After goiburuarekin.

Datuen jatorria: Ministerio de Hacienda (Plataforma de Contratación del Sector Público). Lizitazio bakoitzaren iragarki ofiziala da nagusi.

Gakoarekin: dokumentuak HTTP bidez (beta itxia)

Elkartu, konprimitu eta bihurtu dokumentuak zure kontuko gakoarekin. Beta itxian dago: ordainpeko plana behar du eta Plus eta Pro planetan sartuta dago, eztanda-muga, hileko kuota eta sarrerako mugekin. Bolumen handiagorako edo neurrira egindako integraziorako, idatzi iezaguzu.

Sortu nire gakoa

Autentifikazioa

Eskaera bakoitzak zure gakoa darama goiburuan. Sortu ezazu zure kontuan: behin bakarrik erakusten da, beraz gorde sekretu-kudeatzaile batean. Edozein unetan baliogabetu dezakezu.

Authorization: Bearer papyr_sk_…

Zure lehen deia gakoarekin

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

Eskaneatu bilaketa egin daitekeen PDF batera

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

Atera taulak CSV formatuan

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 Word bihurtu nabigatzailetik

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();

Endpointak (v1)

Endpointak (v1)
GET/api/v1/meZure gakoa balioztatzen du; plana, erabilera eta mugak itzultzen ditu.
POST/api/v1/convert/to-pdfOffice → PDF — file
POST/api/v1/img/compressKonprimatu irudia — file + quality
POST/api/v1/img/convertBihurtu irudia — file + fmt, quality
POST/api/v1/pdf/compressKonprimatu — file
POST/api/v1/pdf/mergeElkartu — files[]
POST/api/v1/pdf/ocrOCR — file + lang
POST/api/v1/pdf/page-numbersZenbakitu orriak — file + position, start
POST/api/v1/pdf/protectBabestu — file + password
POST/api/v1/pdf/rotateBiratu — file + degrees
POST/api/v1/pdf/splitZatitu — file + every/cada
POST/api/v1/pdf/to-csvPDF → CSV — file + sep
POST/api/v1/pdf/to-imagesPDF → irudiak — file + dpi, fmt
POST/api/v1/pdf/to-textPDF → testua — file
POST/api/v1/pdf/to-wordPDF → Word — file + lang
POST/api/v1/pdf/unlockDesblokeatu — file + password
POST/api/v1/pdf/watermarkUr-marka — file + text

Mugak

Erroreak

APIaren errore-erantzun guztiek gorputz bera dute: «error» (kode egonkorra), «detail» (arrazoia, hitzez), «que_hacer» (irtenbidea) eta «ayuda» (taula hau). HTTP kodea ez da aldatzen.

Erroreak
HTTPerrorNoizZer egin
401clave_ausenteEskaerak ez dauka Authorization goiburua.Bidali zure gakoa Authorization: Bearer papyr_sk_… goiburuan. Sortu ezazu hemen: https://www.aim-papyr.ai/eu/account.
401clave_no_validaGakoa ez dago edo indargabetuta dago.Sortu gako berri bat hemen: https://www.aim-papyr.ai/eu/account, eta bidali berriro. Indargabetutako gako batek ez du balio.
403sin_planGako horren kontuak ez du ordainpeko planik.Dokumentuen APIa Plus eta Pro planetan dago barne. Ikusi planak hemen: https://www.aim-papyr.ai/eu/pricing.
404licitacion_no_encontrada«id»-a ez dago Plataformaren kopian.Bilatu ezazu https://www.aim-papyr.ai/v1/licitaciones/buscar bidez eta erabili itzultzen duen «id»-a.
404no_encontradoBidea ez dago.Helbide hori ez dago APIan. Eskuragarri dauden bideak hemen daude: https://www.aim-papyr.ai/eu/api.
413archivo_grandeFitxategiak tamaina-muga gainditzen du.Bidali fitxategi txikiago bat (gehienekoa hemen dago: https://www.aim-papyr.ai/eu/api#limites) edo zatitu lehenago.
422datos_no_validosEremu bat falta da edo ez dauka espero den formatua.Egiaztatu «detail»-ek aipatzen duen eremua eta bidali eskaera berriro. Eremuak eta haien formatuak hemen daude: https://www.aim-papyr.ai/eu/api.
422filtro_no_validoBilaketako iragazki batek (zenbatekoa, egunak, km, udalerria) ez dauka espero den formatua.«importe_min» iragazkiak hau espero du: BEZ gabeko euro-zenbatekoa, zifrak soilik (adibidez 50000). Zuzendu edo kendu eta bidali eskaera berriro; iragazkiak hemen daude: https://www.aim-papyr.ai/eu/api.
429demasiadas_peticionesEztanda-muga edo orduko erabilera-muga gainditu duzu.Itxaron Retry-After goiburuak adierazten dituen segundoak eta errepikatu eskaera.
424pliego_no_disponiblePlegua ezin izan da Plataformatik jaitsi (baztertu egin du edo ez du erantzun).Deskargatu plegu-PDFa bere orri ofizialean eta igo ezazu lizitazioaren fitxan (zure kontuarekin, «Igo PDFa»); gero errepikatu eskaera hau. Minutu batzuk pasatu ondoren ere errepika dezakezu.
429cuota_agotadaKontuaren hileko kuota agortu da.Kuota hilaren 1ean berritzen da. Bolumen handiagoa behar baduzu, ikusi planak hemen: https://www.aim-papyr.ai/eu/pricing.
500error_internoGure aldetik zerbait huts egin du.Errepikatu eskaera segundo batzuk barru. Berdin jarraitzen badu, idatzi https://www.aim-papyr.ai/eu/kontaktua helbidera, ordua eta bidea adierazita.

Adibide bat:

{
  "error": "clave_ausente",
  "detail": "Authorization goiburua falta da: Bearer papyr_sk_…",
  "que_hacer": "Bidali zure gakoa Authorization: Bearer papyr_sk_… goiburuan. Sortu ezazu hemen: https://www.aim-papyr.ai/eu/account.",
  "ayuda": "https://www.aim-papyr.ai/eu/api#errores"
}

Zure datuak non prozesatzen diren

EBko zerbitzarietan (Herbehereak) prozesatzen da zure eragiketarako soilik, eta erantzunarekin batera baztertzen da. APIak webak duen pribatutasun-politika bera jarraitzen du.

Garatzaileentzat   Neurrirako integrazioa, marka zuria edo bolumen handiagoa? Hitz egin gurekin   Pricing