/urakat

Urakoiden tietojen hallinta.

Urakoiden massahaku.

get

Hakee kaikki urakat, joihin järjestelmätunnuksella on oikeudet. Väylän järjestelmille palauttaa kaikki urakat.

get

Palauttaa kaikki urakoitsijan Y-tunnuksen mukaisen urakoitsijan urakoiden otsikkotason tiedot. Urakan täydet tiedot haetaan erikseen urakan id:n avulla (/urakka/id).

get

Urakan haku sijainnilla (ja urakkatyyppillä).

get

Palauttaa id:n mukaisen urakan tiedot sopimuksineen ja tehtävineen. Vastaus kertoo tehtävät, joille voidaan kirjata toteumia. Toteumat kirjataan aina tietyn urakan sopimuksen yksikkö- tai kokonaishintaiselle tehtävälle. Toteumat pitää myös kirjata aina tehtävälle palautuvassa yksikössä.

post

Reittimuotoisten toteumien kirjaaminen urakalle. Yksittäinen reittipiste toteumalle tulisi kirjata aina, kun 1. ajettava tie muuttuu, 2. ajettava tieosa muuttuu, 3. ajettava suunta muuttuu, 4. suoritettava tehtävä muuttuu tai 5. materiaaliannostelijan (esim. suolasirottimen) asetukset muuttuuvat. Toteumien tehtävät raportoidaan aina Harjan urakkahaun palauttamassa yksikössä. Harja ei tee yksikkömuunnoksia vaan olettaa, että määrät on annettu halutussa yksikössä. Sama koskee myös raportoituja materiaalien käyttöjä.

delete

Poista reittitoteuma tunnisteella.

post

Pistemäisten toteumien kirjaaminen urakalle. Toteumien tehtävät raportoidaan aina Harjan urakkahaun palauttamassa yksikössä. Harja ei tee yksikkömuunnoksia vaan olettaa, että määrät on annettu halutussa yksikössä. Sama koskee myös raportoituja materiaalien käyttöjä.

delete

Poista pistetoteuma tunnisteella.

post

Tiemerkintätoteuman kirjaaminen, jota ei kohdisteta ylläpitokohteelle.

delete

Poista tiemerkintätoteuma tunnisteella.

Tarkastusten kirjaaminen

post

Uuden tiestötarkastuspisteen kirjaaminen.

delete

Tiestötarkastuksen poisto.

post

Uuden tieturvallisuustarkastuksen kirjaaminen.

delete

Tieturvallisuustarkastuksen poisto.

post

Uuden talvihoitotarkastuksen mittauspisteen kirjaaminen.

delete

Talvihoitotarkastuksen poisto.

post

Uuden soratietarkastuksen mittauspisteen kirjaaminen.

delete

Soratietarkastuksen poisto.

post

Uuden siltatarkastuksen kirjaaminen.

delete

Siltatarkastuksen poisto.

post

Laadunalitusten kirjaaminen urakalle.

post

Turvallisuuspoikkeamien kuten esim. onnettomuuksien, vaaratilanteiden yms. kirjaaminen. Vakavat turvallisuuspoikkeamat täytyy raportoida Harjaan 24h kuluessa. Lievät turvallisuuspoikkeamat täytyy taas raportoida 5 vuorokauden sisällä. Käsittelyyn liittyvät tiedot voidaan päivittää myöhemmi lähettämällä uusi kutsu samalla turvallisuuspoikkeaman tunnisteella. Vammojen ja vahingoittuneiden ruumiinosien osalta tallennetaan vain ensimmäinen.

post

Päivystäjätietojen lähetys. Tiedot lähetetään aina koko urakalle kerrallaan, jolloin urakan vanhat päivystäjätiedot poistetaan ja vastaanotetut tallennetaan päälle.

delete

Päivystäjätietojen poisto. Poisto tehdään antamalla jokaisen poistettavan päivystyksen yksilöivä id.

get

Päivystäjätietojen haku.

get

Ilmoitusten reaaliakainen haku. Resurssiin tehdään ns. long poll joka jää odottamaan ilmoituksia ulkoisesta järjestelmästä. Kun Harja vastaanottaa ilmoituksen, se palautetaan responsessa, jonka jälkeen kutsuva pää tekee samantien uuden requestin. Parametrinä voidaan antaa myös aikaleima, jonka jälkeen luodut tai muuttuneet ilmoitukset palautetaan. Samoin voidaan kytkeä parametrilla ns. streamaus päälle, jolloin ilmoituksen saavuttua ei tarvitse aina aloittaa uutta requestia.
Harkitse ilmoitusten hakua ytunnuksella käyttöä tämän rajapinnan sijaan.
Vastaussanoman aikaleimat
Ilmoitettu, Ilmoitus tehty Tieliikennekeskukseen.
Valitetty-harjaan, Tieliikennekeskuksen järjestelmän lähetysaikaleima.
Vastaanotettu-harjaan, Ilmoitus tallennettu Harjaan ensimmäisen kerran.
Valitetty-urakkaan, Ilmoitus saatettu urakan tietoon.
Paivitetty-harjaan, Ilmoituksen viimeisin päivitysajankohta. Päivitys on Tieliikennekeskuksesta saapunut päivitys.

Tietyöilmoituksen kirjaus

post

Tietyöilmoituksen kirjaaminen urakalle.

Ylläpitourakoiden kohteiden hallinta.

get

Palauttaa listan urakan ylläpitokohteista. Tiedot tarvitaan, jotta voidana kirjata esim. päällystysilmoitus päällystyskohteelle

Yksittäisen ylläpitokohteen hallinta

put

Ylläpitokohteen tietojen päivitys

post

Aikataulutietojen kirjaus päällystysurakan ylläpitokohteelle. Kirjattaessa aikataulutiedot päällystysilmoitukselle kyseisen ilmoituksen tulee olla lisätty Harjaan, muuten tietoja ei päivitetä.

post

Aikataulutietojen kirjaus tiemerkintäurakan ylläpitokohteelle. Päivitettävän ylläpitokohteen täytyy olla merkitty urakkaan suorittavaksi tiemerkintäurakaksi.

post

Tietyömaan kirjaaminen. Uusi kirjaus tehdään aina, kun tietyömaa alkaa tai kun sen sijainti muuttuu. Osuuden sijanti määräytyy kohteen alkuun ja loppuun asetettujen liikenneohjausaitojen sijaintien perusteella.

delete

Tietyömaan poistaminen. Poisto tehdään, kun liikenteenohjausaidat on poistettu.

post

Kohteen määrämuutosten (taloudellisen osan kirjaus). Rajapinnan kautta voidana päivittää kohteen kulutiedot, kuten esim. yksittäiset työt, yksikköhintoineen ja määrineen. Yksittäinen kutsu rajapintaan poistaa saman käyttäjän luomat olemassaolevat tiedot ja päivittää ne annetuilla. Tarkoitus on siis, että kaikki kohteen määrämuutokset välitetään jokaisessa kutsussa. Kentistä "ennustettu-maara" ja "toteutunut-maara" on pakko antaa ainakin toinen.

post

Tarkastuksen kirjaaminen ylläpitokohteelle (katselmus, pistokoe, vastaanottotarkastus, takuutarkastus)

delete

Ylläpitokohteen tarkastuksen poisto

post

Tiemerkinnän toteuman kirjaus ylläpitokohteelle

delete

Ylläpitokohteen tiemerkintätoteuman poistaminen

Paikkauskohteiden ja niihin liittyvien paikkausten kirjaus ja päivitys. Massamenekki on poistumassa käytöstä, sen sijaan tulisi käyttää massamäärää kilogrammoina.

post

Uuden paikkauksen kirjaaminen tai vanhan päivittäminen.

delete

Paikkauskohteiden ja niihin liittyvien paikkausten ja/tai paikkauskustannusten poisto. Kun poistat paikkauskohteen, siihen liittyvät paikkaukset ja paikkauskustannukset poistetaan. Paikkauksia ja paikkauskustannuksia voi poistosanoman avulla poistaa myös yksitellen. Tällöin paikkauskohdetta ei poisteta.

post

Uuden paikkauksen kustannusten kirjaaminen tai vanhan päivittäminen paikkauksille.

post

Uuden reikäpaikkauksen kirjaaminen.

put

Jo lähetetyn reikäpaikkauksen päivitys.

delete

Reikäpaikkausten poisto

post

Deprekoituu 31.12.2025. Käytä uudempaa rajapintaa, jossa asetetaan query parametri

put

Työmaapäiväkirjan päivittäminen. Deprekoituu 31.12.2024. Siirry käyttämään uudempaa versiota, jossa versionumero annetaan query parametrilla ja päivitettävä työmaapäiväkirja päätellään päivästä, eikä url parametrista.

post

Talvihoitoreitin lisäys.

put

Talvihoitoreitin päivitys.

delete

Talvihoitoreitin poisto.

get

Materiaaliraportin haku. Haun rajaus päivämäärävälillä, jonka suurin sallittu aikaväli on yksi vuosi. Rajapinta hakee Harjan välimuistissa olevat tiedot, joten ne eivät välttämättä ole täysin ajantasaisia. Raportin tiedot päivitetään Harjan välimuistiin joka yö eräajossa. ajat tulee antaaa ISO-8601-muodossa, url-enkoodattuna, esim. 2023-04-11T21%3A00%3A00Z.

get

Urakan yhteystietojen haku urakkanumerolla. Palauttaa urakan yhteystiedot sekä yhteyshenkiöt

post

Urakan työtuntien kirjaus vuosikolmanneksittain. Kolmannekset ovat 1 tammi-huhtikuu, 2 touko-elokuu, 3 syys-joulukuu.

/seuranta

Reaaliaikaisten tapahtumien kirjaus.

post

Työkoneen seurantatiedon kirjaus. Sijantitiedot lähetetään maksimissaan 5 sekunnin välein ja mahdollisuuksien mukaan mieluusti 5-15 sekunnin intervalilla. Mikäli työkone on paikallaan, suunta-tiedon voi jättää pois tai suunnaksi voi välittää arvon null. Ylläpito-urakoissa Tilannekuvassa näytetään työkonetyypit

post

Työkoneen seurantatiedon kirjaus viivageometrialla. Sijantitiedot lähetetään maksimissaan 5 sekunnin välein ja mahdollisuuksien mukaan mieluusti 5-15 sekunnin intervalilla ja otoskoolla. Mikäli työkone on paikallaan, suunta-tiedon voi jättää pois tai suunnaksi voi välittää arvon null. Ylläpito-urakoissa Tilannekuvassa näytetään työkonetyypit

/ilmoitukset

Ilmoitusten hallinta.

Yksittäisen ilmoituksen hallinta.

put

Ilmoitustoimenpiteen eli kuittauksen kirjaus. Käytetään kirjaamaan eri toimenpiteet ilmoituksille, kuten vastaanotto, muutos, aloitus, lopetus.

get

Palauttaa urakoitsijan annetun aikahaarukan välillä päivittyneet ilmoitukset toimenpidekuittauksineen. Ilmoitus katsotaan päivittyneeksi, kun se saapuu urakkaan, kun siihen saadaan Tieliikennekeskuksesta päivitys ja kun siihen tehdään toimenpidekuittaus. Esim. ilmoitukset%2f123456-7%2f2022-01-02T00:01:00+03%2f2022-01-02T00:02:00+03.
Vastaussanoman aikaleimat
Ilmoitettu, Ilmoitus tehty Tieliikennekeskukseen.
Valitetty-harjaan, Tieliikennekeskuksen järjestelmän lähetysaikaleima.
Vastaanotettu-harjaan, Ilmoitus tallennettu Harjaan ensimmäisen kerran.
Valitetty-urakkaan, Ilmoitus saatettu urakan tietoon.
Paivitetty-harjaan, Ilmoituksen viimeisin päivitysajankohta. Päivitys on Tieliikennekeskuksesta saapunut päivitys.

/tieluvat

Tielupien haku

post

Uuden tieluvan kirjaus

get

Tielupien haku alueurakan tai sijainnin perusteella.

get

Yksittäisen tieluvan haku diaarinumeron avulla.

/paivystajatiedot

Päivystäjätietojen hallinta

Päivystäjätietojen haku

get

Päivystäjätietojen haku puhelinnumerolla.

get

Päivystäjätietojen haku sijainnilla.