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 clauAutenticació
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
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.pdfExtreure taules a CSV
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 a Word des del navegador
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();
Endpoints (v1)
| GET | /api/v1/me | Valida la teva clau i retorna el pla, el consum i els límits. |
|---|---|---|
| POST | /api/v1/convert/to-pdf | Office → PDF — file |
| POST | /api/v1/img/compress | Comprimir imatge — file + quality |
| POST | /api/v1/img/convert | Convertir imatge — file + fmt, quality |
| POST | /api/v1/pdf/compress | Comprimir — file |
| POST | /api/v1/pdf/merge | Unir — files[] |
| POST | /api/v1/pdf/ocr | OCR — file + lang |
| POST | /api/v1/pdf/page-numbers | Numerar — file + position, start |
| POST | /api/v1/pdf/protect | Protegir — file + password |
| POST | /api/v1/pdf/rotate | Girar — file + degrees |
| POST | /api/v1/pdf/split | Dividir — file + every/cada |
| POST | /api/v1/pdf/to-csv | PDF → CSV — file + sep |
| POST | /api/v1/pdf/to-images | PDF → imatges — file + dpi, fmt |
| POST | /api/v1/pdf/to-text | PDF → Text — file |
| POST | /api/v1/pdf/to-word | PDF → Word — file + lang |
| POST | /api/v1/pdf/unlock | Desbloquejar — file + password |
| POST | /api/v1/pdf/watermark | Marca d'aigua — file + text |
Límits
- Ràfega: 20 peticions per minut; sostingut: 300 per hora i per clau.
- Quota mensual per compte segons el pla (Plus: 300; Pro: 1.000 crides al mes). Cada resposta inclou X-Monthly-Used i X-Monthly-Limit.
- Fitxers de fins a 50 MB.
- Errors: 401 clau no vàlida, 403 sense pla de pagament, 413 fitxer massa gran, 429 límit assolit (amb Retry-After).
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.
| HTTP | error | Quan | Què fer |
|---|---|---|---|
| 401 | clave_ausente | La 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. |
| 401 | clave_no_valida | La 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. |
| 403 | sin_plan | El 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. |
| 404 | licitacion_no_encontrada | L'«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. |
| 404 | no_encontrado | La ruta no existeix. | Aquesta adreça no existeix a l'API. Les rutes disponibles són a https://www.aim-papyr.ai/ca/api. |
| 413 | archivo_grande | El 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. |
| 422 | datos_no_validos | Falta 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. |
| 422 | filtro_no_valido | Un 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. |
| 429 | demasiadas_peticiones | Has 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ó. |
| 424 | pliego_no_disponible | El 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. |
| 429 | cuota_agotada | La 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. |
| 500 | error_interno | Alguna 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