API pubblika tas-sejħiet għall-offerti

Tendova tippubblika d-dejta tas-sejħiet li tiġbor minn TED bħala API JSON għall-qari biss. Hija bla ħlas, tista' tiġi ppruvata mingħajr ċavetta u tagħti l-istess avviżi li juri s-sit.

X'tagħti lura l-API

Żewġ punti finali, it-tnejn f'JSON u t-tnejn għall-qari biss.

GET /api/tenders — tfittex sejħiet attivi skont test sħiħ, pajjiż, kodiċi CPV u ordni, u tagħti paġna waħda ta' riżultati flimkien mal-paġnar.
GET /api/tenders/{id} — tagħti sejħa waħda sħiħa: l-awtorità kontraenti, il-kodiċijiet CPV, il-post tat-twettiq, il-valur stmat, l-iskadenzi u l-links uffiċjali għas-sors.
It-titli u d-deskrizzjonijiet jingħataw f'kull waħda mill-24 lingwa uffiċjali tal-UE permezz tal-parametru locale.

Is-sommarji tal-IA, il-punteġġi ta' tqabbil, il-verifiki ta' adegwatezza u l-analiżi tad-dokumenti qatt ma jagħmlu parti minn tweġiba tal-API. Jibqgħu ġewwa l-prodott.

Awtentikazzjoni

Biex tipprova l-API m'hemmx bżonn ċavetta. Ibgħat waħda hekk kif tibni fuqha: iċ-ċwievet huma bla ħlas f'kull pjan u jgħollu l-baġit tiegħek. Taħdem kwalunkwe waħda miż-żewġ intestaturi.

Authorization: Bearer tdv_live_…
X-Api-Key: tdv_live_…

Ċavetta mhux magħrufa, ħażina jew revokata tiġi rifjutata b'HTTP 401 u l-kodiċi ta' żball invalid_api_key. Li ma tibgħat ebda ċavetta hija sejħa anonima, mhux żball.

Oħloq ċavetta fil-kont tiegħek

Limiti tas-sejħiet

Min isejjaħ	Baġit ta' talbiet	Rekords f'kull talba
Mingħajr ċavetta	20 talbiet fil-minuta għal kull indirizz IP	sa 20
Ċavetta fil-pjan Free	500 talbiet kuljum għal kull ċavetta	sa 20
Ċavetta fil-pjan Pro	10,000 talbiet kuljum għal kull ċavetta	sa 50

Is-sejħiet biċ-ċavetta jgħaddu wkoll minn protezzjoni tal-quċċata ta' 60 talbiet fil-minuta, biex baġit ta' kuljum ma jintużax kollu f'daqqa.

Kull tweġiba ġġorr x-ratelimit-limit u x-ratelimit-remaining. Sejħa lil hinn mil-limitu tagħti HTTP 429 b'retry-after f'sekondi.

Eżempji

Tfittxija ta' sejħiet

curl -s "https://tendova.eu/api/tenders?q=software&country=DE&limit=20&locale=mt" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Ksib ta' sejħa waħda

curl -s "https://tendova.eu/api/tenders/{id}?locale=mt" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Ħalli barra l-intestatura Authorization biex issejjaħ b'mod anonimu. Kull element tal-lista jġorr il-qasam apiUrl: l-indirizz tad-dettalji ta' dik is-sejħa, lest biex jinġieb.

Għall-aġenti tal-IA

Fajl qasir ta' orjentazzjoni jiddeskrivi l-istess punti finali fil-format llmstxt.org, għall-assistenti tal-kodiċi u l-oqfsa tal-aġenti.

Iftaħ llms.txt

Minn fejn tiġi d-dejta

L-avviżi kollha jiġu minn Tenders Electronic Daily (TED), il-ġurnal uffiċjali tal-akkwist pubbliku tal-UE. Tendova żżid it-traduzzjoni, l-istruttura u t-tiftix; l-avviżi nfushom jibqgħu dejta pubblika.

Għal aċċess bl-ingrossa jew kummerċjali għad-dejta, ikteb lil [email protected].