TED API for anbudsdata
TED tilbyr et åpent søke-API for publiserte kunngjøringer og et separat, autentisert API for publisering.
TED API gir maskinell tilgang til kunngjøringer i Tenders Electronic Daily, EUs database for offentlige anskaffelser. To grensesnitt må holdes tydelig fra hverandre: Search API for publiserte data og Publication API for innsending.
Search API
TED Search API er rettet mot dataforbrukere, forskere, utviklere og kommersielle tjenester. Det krever ikke autentisering. Søk sendes som POST /v3/notices/search med en ekspertspørring, ønskede felt og pagineringsvalg.
Det kan brukes til:
- markedssøk på oppdragsgiver, land, CPV, dato og kunngjøringstype
- historiske analyser av konkurranser og tildelinger
- varsling om nye publiserte kunngjøringer
- nedlasting av kunngjøringer i XML for gjenbruk
Vanlig paginering har grenser. For større uttrekk støtter API-et iterasjon med token. En produksjonstjeneste bør lagre siste vellykkede posisjon, tåle duplikater og kjøre periodisk avstemming.
Publication API
Publication API brukes av eSendere og offentlige oppdragsgivere til å sende eForms-kunngjøringer. Det krever API-nøkkel og har operasjoner for innsending, status, stopp av publisering og valideringsrapport.
For norske kunngjøringer er normalarkitekturen likevel at KGV sender via Doffin. DFØ opplyser at Doffin er Norges eneste eSender til TED. TEDs publiserings-API bør derfor ikke behandles som en snarvei rundt Doffin .
Hva TED-data ikke dekker
TED dekker publiseringer som hører hjemme i det europeiske kunngjøringsløpet. En tjeneste som lover komplett oversikt over alle norske offentlige muligheter må undersøke hvordan nasjonale kunngjøringer under EØS-terskelverdiene dekkes.
Vis også datakvalitet og tidspunkt. En kunngjøring kan bli rettet eller avlyst. Bruk identifikatorer og versjoner til å oppdatere samme ressurs, og behold historikk som forklarer endringen.
Forslag til datamodell
| Objekt | Nøkkeldata |
|---|---|
| Kunngjøring | TED-ID, versjon, type, publiseringsdato og språk |
| Konkurranse | Oppdragsgiver, CPV, sted, frist og prosedyre |
| Delkontrakt | Egen verdi, krav, sted og status |
| Dokument | Offisiell URL, format og språk |
| Hendelse | Ny, endret, avlyst eller tildelt |
Bevar rådata ved siden av normaliserte felt. Da kan en parser forbedres uten å hente hele historikken på nytt.
AI og søk
AI kan klassifisere og oppsummere kunngjøringer, men bør ikke endre bindende fakta. Vis kilde, hentetidspunkt og direkte lenke til offisiell kunngjøring. Merk tydelig hva som er generert, og la brukeren kontrollere frister og krav i originalen.
Les offentlige API-er for anskaffelser og bygging av anskaffelsesplattform .
Offisielle kilder
Se TED Search API og TED Publication API . Endepunkter og grenser kan endres; bruk gjeldende Swagger-dokumentasjon ved implementasjon.