Avalik hanke-API

Tendova avaldab TEDist kogutud hankeandmed ainult lugemiseks mõeldud JSON-API-na. See on tasuta, seda saab proovida ilma võtmeta ja see tagastab samad teated, mida näitab veebisait.

Mida API tagastab

Kaks lõpp-punkti, mõlemad JSON-vormingus ja ainult lugemiseks.

GET /api/tenders — otsib aktiivseid hankeid täisteksti, riigi, CPV-koodi ja järjestuse alusel ning tagastab ühe lehe tulemusi koos lehekülgedeks jaotamisega.
GET /api/tenders/{id} — tagastab ühe hanke tervikuna: hankija, CPV-koodid, täitmise koht, eeldatav maksumus, tähtajad ja ametlikud lähtelingid.
Pealkirjad ja kirjeldused tagastatakse parameetri locale kaudu kõigis 24 ELi ametlikus keeles.

Tehisintellekti kokkuvõtted, vastavusskoorid, sobivuskontrollid ja dokumendianalüüs ei kuulu kunagi API vastusesse. Need jäävad toote sisse.

Autentimine

API proovimiseks võtit vaja ei ole. Saatke võti kohe, kui hakkate sellele ehitama: võtmed on kõigis pakettides tasuta ja suurendavad teie limiiti. Töötab kumbki päis.

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

Tundmatu, vigane või tühistatud võti lükatakse tagasi koodiga HTTP 401 ja veakoodiga invalid_api_key. Võtme puudumine on anonüümne päring, mitte viga.

Looge võti oma kontol

Päringupiirangud

Päringu tegija	Päringulimiit	Kirjeid päringu kohta
Ilma võtmeta	20 päringut minutis IP-aadressi kohta	kuni 20
Võti paketis Free	500 päringut päevas võtme kohta	kuni 20
Võti paketis Pro	10 000 päringut päevas võtme kohta	kuni 50

Võtmega päringud läbivad lisaks tipukaitse 60 päringut minutis, nii et päevalimiiti ei saa korraga ära kulutada.

Iga vastus kannab päiseid x-ratelimit-limit ja x-ratelimit-remaining. Piirist üle minev päring tagastab HTTP 429 ja retry-after sekundites.

Näited

Hangete otsimine

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

Ühe hanke pärimine

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

Anonüümseks päringuks jätke päis Authorization ära. Iga loendikirje kannab välja apiUrl: selle hanke valmis üksikasjade aadressi.

Tehisintellekti agentidele

Lühike suunisfail kirjeldab samu lõpp-punkte llmstxt.org vormingus, koodiabiliste ja agendiraamistike jaoks.

Ava llms.txt

Kust andmed pärinevad

Kõik teated pärinevad andmebaasist Tenders Electronic Daily (TED), ELi ametlikust riigihangete väljaandest. Tendova lisab tõlke, struktuuri ja otsingu; teated ise jäävad avalikeks andmeteks.

Masspäringute või ärilise andmejuurdepääsu asjus kirjutage aadressil [email protected].