Javni API razpisov

Tendova objavlja podatke o razpisih, zbrane iz TED, kot JSON API samo za branje. Je brezplačen, preizkusite ga lahko brez ključa in vrača ista obvestila, kot jih prikazuje spletno mesto.

Kaj API vrne

Dve končni točki, obe v JSON in obe samo za branje.

GET /api/tenders — išče dejavne razpise po celotnem besedilu, državi, kodi CPV in razvrstitvi ter vrne eno stran zadetkov s podatki o oštevilčenju.
GET /api/tenders/{id} — vrne celoten razpis: naročnika, kode CPV, kraj izvedbe, ocenjeno vrednost, roke in uradne povezave do vira.
Naslovi in opisi se prek parametra locale vrnejo v katerem koli od 24 uradnih jezikov EU.

Povzetki UI, ocene ujemanja, presoje primernosti in analiza dokumentov niso nikoli del odgovora API. Ostanejo znotraj izdelka.

Preverjanje pristnosti

Za preizkus API ključa ne potrebujete. Pošljite ga takoj, ko na njem gradite: ključi so brezplačni v vseh paketih in povečajo vašo kvoto. Deluje katera koli od glav.

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

Neznan, napačen ali preklican ključ je zavrnjen s HTTP 401 in kodo napake invalid_api_key. Če ključa ne pošljete, gre za anonimni klic in ne za napako.

Ustvarite ključ v svojem računu

Omejitve klicev

Klicatelj	Kvota zahtevkov	Zapisov na zahtevek
Brez ključa	20 zahtevkov na minuto na naslov IP	do 20
Ključ v paketu Free	500 zahtevkov na dan na ključ	do 20
Ključ v paketu Pro	10.000 zahtevkov na dan na ključ	do 50

Klici s ključem prestanejo še varovalko za konice 60 zahtevkov na minuto, tako da dnevne kvote ni mogoče porabiti naenkrat.

Vsak odgovor vsebuje x-ratelimit-limit in x-ratelimit-remaining. Klic nad omejitvijo vrne HTTP 429 z glavo retry-after v sekundah.

Primeri

Iskanje razpisov

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

Pridobitev enega razpisa

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

Glavo Authorization izpustite za anonimni klic. Vsak element seznama nosi polje apiUrl: pripravljen naslov podrobnosti tega razpisa.

Za agente UI

Kratka datoteka za orientacijo opisuje iste končne točke v obliki llmstxt.org, za pomočnike pri kodiranju in ogrodja za agente.

Odpri llms.txt

Od kod prihajajo podatki

Vsa obvestila prihajajo iz Tenders Electronic Daily (TED), uradnega lista javnih naročil EU. Tendova dodaja prevod, strukturo in iskanje; obvestila sama ostajajo javni podatki.

Za množični ali komercialni dostop do podatkov pišite na [email protected].