Julkinen tarjouspyyntö-API

Tendova julkaisee TED-palvelusta keräämänsä hankintatiedot vain luettavana JSON-API:na. Se on maksuton, sitä voi kokeilla ilman avainta ja se palauttaa samat ilmoitukset kuin sivusto näyttää.

Mitä API palauttaa

Kaksi päätepistettä, molemmat JSON-muodossa ja vain luettavia.

GET /api/tenders — hakee aktiivisia hankintoja vapaalla tekstillä, maalla, CPV-koodilla ja järjestyksellä ja palauttaa yhden sivullisen tuloksia sivutustietoineen.
GET /api/tenders/{id} — palauttaa yhden hankinnan kokonaan: hankintayksikkö, CPV-koodit, suorituspaikka, arvioitu arvo, määräajat ja viralliset lähdelinkit.
Otsikot ja kuvaukset palautuvat millä tahansa EU:n 24 virallisesta kielestä locale-parametrin avulla.

Tekoälytiivistelmät, osumapisteet, soveltuvuusarviot ja asiakirja-analyysi eivät koskaan kuulu API-vastaukseen. Ne pysyvät tuotteen sisällä.

Todennus

API:n kokeiluun ei tarvita avainta. Lähetä avain heti kun rakennat sen varaan: avaimet ovat maksuttomia kaikissa tilauksissa ja kasvattavat kiintiötäsi. Kumpi tahansa otsake toimii.

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

Tuntematon, virheellinen tai mitätöity avain hylätään koodilla HTTP 401 ja virhekoodilla invalid_api_key. Ilman avainta tehty kutsu on nimetön kutsu, ei virhe.

Luo avain tililläsi

Kutsurajat

Kutsuja	Pyyntökiintiö	Tietueita pyyntöä kohden
Ilman avainta	20 pyyntöä minuutissa IP-osoitetta kohden	enintään 20
Avain Free-tilauksella	500 pyyntöä päivässä avainta kohden	enintään 20
Avain Pro-tilauksella	10 000 pyyntöä päivässä avainta kohden	enintään 50

Avaimella tehdyt kutsut läpäisevät lisäksi 60 pyyntöä minuutissa -huippusuojan, jotta päiväkiintiötä ei voi kuluttaa kerralla.

Jokainen vastaus sisältää otsakkeet x-ratelimit-limit ja x-ratelimit-remaining. Rajan ylittävä kutsu palauttaa koodin HTTP 429 ja retry-after-arvon sekunteina.

Esimerkkejä

Hankintojen haku

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

Yhden hankinnan haku

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

Jätä Authorization-otsake pois kutsuaksesi nimettömänä. Jokaisessa listan kohteessa on apiUrl-kenttä: kyseisen hankinnan valmis tieto-osoite.

Tekoälyagenteille

Lyhyt opastetiedosto kuvaa samat päätepisteet llmstxt.org-muodossa koodiavustajia ja agenttikehyksiä varten.

Avaa llms.txt

Mistä tiedot tulevat

Kaikki ilmoitukset ovat peräisin Tenders Electronic Daily (TED) -palvelusta, EU:n virallisesta hankintalehdestä. Tendova lisää käännöksen, rakenteen ja haun; ilmoitukset itsessään pysyvät julkisina tietoina.

Joukko- tai kaupallisesta tiedonsaannista kirjoita osoitteeseen [email protected].