API poiblí tairiscintí

Foilsíonn Tendova na sonraí tairisceana a bhailítear ó TED mar API JSON léimh amháin. Tá sé saor in aisce, is féidir triail a bhaint as gan eochair, agus tugann sé na fógraí céanna a thaispeánann an suíomh.

Cad a thugann an API ar ais

Dhá chríochphointe, JSON araon agus léamh amháin araon.

GET /api/tenders — cuardaíonn sé tairiscintí gníomhacha de réir téacs iomláin, tíre, cóid CPV agus sórtála, agus tugann sé leathanach amháin torthaí mar aon le sonraí leathanaigh.
GET /api/tenders/{id} — tugann sé tairiscint amháin ina hiomláine: an ceannaitheoir, cóid CPV, áit an chomhlíonta, luach measta, spriocdhátaí agus na naisc oifigiúla foinse.
Tugtar teidil agus cur síos ar ais in aon cheann de 24 teanga oifigiúla an AE tríd an bpaiméadar locale.

Ní bhíonn achoimrí intleachta saorga, scóir mheaitseála, seiceálacha oiriúnachta ná anailís cáipéisí riamh mar chuid de fhreagra API. Fanann siad laistigh den táirge.

Fíordheimhniú

Níl eochair ag teastáil chun triail a bhaint as an API. Seol ceann chomh luath agus a thógann tú air: tá eochracha saor in aisce ar gach plean agus ardaíonn siad do bhuiséad. Oibríonn ceachtar ceanntásc.

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

Diúltaítear eochair anaithnid, mhícheart nó chúlghairthe le HTTP 401 agus an cód earráide invalid_api_key. Is glao gan ainm é gan aon eochair a sheoladh, ní earráid.

Cruthaigh eochair i do chuntas

Teorainneacha glaonna

Glaoiteoir	Buiséad iarratas	Taifid in aghaidh an iarratais
Gan eochair	20 iarratas in aghaidh an nóiméid, in aghaidh an seoladh IP	suas le 20
Eochair ar an bplean Free	500 iarratas in aghaidh an lae, in aghaidh na heochrach	suas le 20
Eochair ar an bplean Pro	10,000 iarratas in aghaidh an lae, in aghaidh na heochrach	suas le 50

Gabhann glaonna le heochair trí chosaint bhuaice 60 iarratas in aghaidh an nóiméid freisin, sa chaoi nach féidir buiséad laethúil a chaitheamh in aon iarraidh amháin.

Iompraíonn gach freagra x-ratelimit-limit agus x-ratelimit-remaining. Tugann glao os cionn na teorann HTTP 429 le retry-after i soicindí.

Samplaí

Tairiscintí a chuardach

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

Tairiscint amháin a fháil

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

Fág an ceanntásc Authorization ar lár chun glaoch gan ainm. Iompraíonn gach mír sa liosta réimse apiUrl: URL sonraí na tairisceana sin, réidh le fáil.

Do ghníomhairí intleachta saorga

Déanann comhad gairid treorach cur síos ar na críochphointí céanna i bhformáid llmstxt.org, do chúntóirí códála agus creataí gníomhairí.

Oscail llms.txt

Cad as a dtagann na sonraí

Tagann gach fógra ó Tenders Electronic Daily (TED), iris oifigiúil soláthair an AE. Cuireann Tendova aistriúchán, struchtúr agus cuardach leis; fanann na fógraí féin ina sonraí poiblí.

Le haghaidh rochtain mhórchóir nó tráchtála ar shonraí, scríobh chuig [email protected].