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 gakoaAutentifikazioa
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
bashcurl -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.pdfAtera taulak CSV formatuan
pythonimport 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
javascriptconst 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)
| GET | /api/v1/me | Zure gakoa balioztatzen du; plana, erabilera eta mugak itzultzen ditu. |
|---|---|---|
| POST | /api/v1/convert/to-pdf | Office → PDF — file |
| POST | /api/v1/img/compress | Konprimatu irudia — file + quality |
| POST | /api/v1/img/convert | Bihurtu irudia — file + fmt, quality |
| POST | /api/v1/pdf/compress | Konprimatu — file |
| POST | /api/v1/pdf/merge | Elkartu — files[] |
| POST | /api/v1/pdf/ocr | OCR — file + lang |
| POST | /api/v1/pdf/page-numbers | Zenbakitu orriak — file + position, start |
| POST | /api/v1/pdf/protect | Babestu — file + password |
| POST | /api/v1/pdf/rotate | Biratu — file + degrees |
| POST | /api/v1/pdf/split | Zatitu — file + every/cada |
| POST | /api/v1/pdf/to-csv | PDF → CSV — file + sep |
| POST | /api/v1/pdf/to-images | PDF → irudiak — file + dpi, fmt |
| POST | /api/v1/pdf/to-text | PDF → testua — file |
| POST | /api/v1/pdf/to-word | PDF → Word — file + lang |
| POST | /api/v1/pdf/unlock | Desblokeatu — file + password |
| POST | /api/v1/pdf/watermark | Ur-marka — file + text |
Mugak
- Eztanda: 20 eskaera minutuko; jarraitua: 300 orduko eta gako bakoitzeko.
- Hileko kuota kontuko, planaren arabera (Plus: 300; Pro: 1.000 dei hilean). Erantzun bakoitzak X-Monthly-Used eta X-Monthly-Limit ditu.
- 50 MB arteko fitxategiak.
- Erroreak: 401 gako baliogabea, 403 ordainpeko planik gabe, 413 fitxategi handiegia, 429 muga gaindituta (Retry-After goiburuarekin).
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.
| HTTP | error | Noiz | Zer egin |
|---|---|---|---|
| 401 | clave_ausente | Eskaerak ez dauka Authorization goiburua. | Bidali zure gakoa Authorization: Bearer papyr_sk_… goiburuan. Sortu ezazu hemen: https://www.aim-papyr.ai/eu/account. |
| 401 | clave_no_valida | Gakoa 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. |
| 403 | sin_plan | Gako horren kontuak ez du ordainpeko planik. | Dokumentuen APIa Plus eta Pro planetan dago barne. Ikusi planak hemen: https://www.aim-papyr.ai/eu/pricing. |
| 404 | licitacion_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. |
| 404 | no_encontrado | Bidea ez dago. | Helbide hori ez dago APIan. Eskuragarri dauden bideak hemen daude: https://www.aim-papyr.ai/eu/api. |
| 413 | archivo_grande | Fitxategiak tamaina-muga gainditzen du. | Bidali fitxategi txikiago bat (gehienekoa hemen dago: https://www.aim-papyr.ai/eu/api#limites) edo zatitu lehenago. |
| 422 | datos_no_validos | Eremu 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. |
| 422 | filtro_no_valido | Bilaketako 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. |
| 429 | demasiadas_peticiones | Eztanda-muga edo orduko erabilera-muga gainditu duzu. | Itxaron Retry-After goiburuak adierazten dituen segundoak eta errepikatu eskaera. |
| 424 | pliego_no_disponible | Plegua 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. |
| 429 | cuota_agotada | Kontuaren hileko kuota agortu da. | Kuota hilaren 1ean berritzen da. Bolumen handiagoa behar baduzu, ikusi planak hemen: https://www.aim-papyr.ai/eu/pricing. |
| 500 | error_interno | Gure 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