Praleisti į turinį

Viešoji pirkimų API

Tendova skelbia iš TED surinktus pirkimų duomenis kaip tik skaitymo JSON API. Ji nemokama, išbandoma be rakto ir grąžina tuos pačius skelbimus, kuriuos rodo svetainė.

Ką grąžina API

Du galiniai taškai, abu JSON formatu ir abu tik skaitymui.

  • GET /api/tenders — ieško aktyvių pirkimų pagal visą tekstą, šalį, CPV kodą ir rikiavimą ir grąžina vieną rezultatų puslapį su puslapiavimo duomenimis.
  • GET /api/tenders/{id} — grąžina visą pirkimą: perkančiąją organizaciją, CPV kodus, vykdymo vietą, numatomą vertę, terminus ir oficialias nuorodas į šaltinį.
  • Pavadinimai ir aprašymai grąžinami bet kuria iš 24 oficialių ES kalbų naudojant parametrą locale.

DI santraukos, atitikties įvertinimai, tinkamumo patikros ir dokumentų analizė niekada nėra API atsakymo dalis. Jos lieka produkto viduje.

Tapatumo nustatymas

Norint išbandyti API, rakto nereikia. Siųskite jį vos tik pradedate ant jos kurti: raktai nemokami visuose planuose ir padidina jūsų limitą. Tinka bet kuri antraštė.

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

Nežinomas, netaisyklingas arba panaikintas raktas atmetamas su HTTP 401 ir klaidos kodu invalid_api_key. Visai neatsiųstas raktas yra anoniminė užklausa, o ne klaida.

Sukurkite raktą savo paskyroje

Užklausų ribos

IškviečiantysisUžklausų limitasĮrašų viename atsakyme
Be rakto20 užklausų per minutę iš vieno IP adresoiki 20
Raktas plane Free500 užklausų per dieną vienam raktuiiki 20
Raktas plane Pro10 000 užklausų per dieną vienam raktuiiki 50

Užklausos su raktu papildomai praeina pikų apsaugą 60 užklausų per minutę, kad dienos limito nebūtų galima išnaudoti iškart.

Kiekviename atsakyme yra x-ratelimit-limit ir x-ratelimit-remaining. Ribą viršijanti užklausa grąžina HTTP 429 su retry-after sekundėmis.

Pavyzdžiai

Pirkimų paieška

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

Vieno pirkimo gavimas

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

Praleiskite antraštę Authorization, kad iškviestumėte anonimiškai. Kiekvienas sąrašo įrašas turi lauką apiUrl: paruoštą to pirkimo detalių adresą.

DI agentams

Trumpas orientacinis failas aprašo tuos pačius galinius taškus llmstxt.org formatu, skirtas kodo asistentams ir agentų karkasams.

Atidaryti llms.txt

Iš kur gaunami duomenys

Visi skelbimai gaunami iš Tenders Electronic Daily (TED), oficialaus ES viešųjų pirkimų leidinio. Tendova prideda vertimą, struktūrą ir paiešką; patys skelbimai lieka vieši duomenys.

Contains data from Tenders Electronic Daily (TED), © European Union, ted.europa.eu — CC BY 4.0.

Dėl masinės ar komercinės prieigos prie duomenų rašykite adresu [email protected].