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 claveAutenticació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
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.pdfExtraer táboas 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 desde o 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 a túa clave; devolve o plan, o uso e os límites. |
|---|---|---|
| POST | /api/v1/convert/to-pdf | Office → PDF — file |
| POST | /api/v1/img/compress | Comprimir imaxe — file + quality |
| POST | /api/v1/img/convert | Converter imaxe — 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 | Números de páxina — file + position, start |
| POST | /api/v1/pdf/protect | Protexer — file + password |
| POST | /api/v1/pdf/rotate | Xirar — 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 → imaxes — file + dpi, fmt |
| POST | /api/v1/pdf/to-text | PDF → Texto — file |
| POST | /api/v1/pdf/to-word | PDF → Word — file + lang |
| POST | /api/v1/pdf/unlock | Desbloquear — file + password |
| POST | /api/v1/pdf/watermark | Marca de auga — file + text |
Límites
- Ráfaga: 20 peticións por minuto; sostido: 300 por hora e por clave.
- Cota mensual por conta segundo o plan (Plus: 300; Pro: 1.000 chamadas ao mes). Cada resposta inclúe X-Monthly-Used e X-Monthly-Limit.
- Ficheiros de ata 50 MB.
- Erros: 401 clave non válida, 403 sen plan de pago, 413 ficheiro demasiado grande, 429 límite alcanzado (con Retry-After).
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.
| HTTP | error | Cando | Que facer |
|---|---|---|---|
| 401 | clave_ausente | A 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. |
| 401 | clave_no_valida | A 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. |
| 403 | sin_plan | A 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. |
| 404 | licitacion_no_encontrada | O «id» non está na copia da Plataforma. | Búscaa con https://www.aim-papyr.ai/v1/licitaciones/buscar e usa o «id» que devolve. |
| 404 | no_encontrado | A ruta non existe. | Esa dirección non existe na API. As rutas dispoñibles están en https://www.aim-papyr.ai/gl/api. |
| 413 | archivo_grande | O 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. |
| 422 | datos_no_validos | Falta 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. |
| 422 | filtro_no_valido | Un 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. |
| 429 | demasiadas_peticiones | Pasaches 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. |
| 424 | pliego_no_disponible | O 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. |
| 429 | cuota_agotada | A 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. |
| 500 | error_interno | Algo 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