Matkustajainformaation tiedotteet GraphQL-rajapinnassa testattavana / Passenger information messages available in GraphQL for testing

[rata.digitraffic.fi]

Hei,

Digitrafficin testipuolella on nyt mahdollista hakea matkustajainformaation tiedotteita GraphQL-rajapinnan kautta.

Tiedotteisiin on mahdollista linkittää niihin liittyvät asemat ja junat. Junaan on myös mahdollista linkittää siihen liittyvät matkustajainformaatiotiedotteet. Tällä hetkellä rajapinta palauttaa kaikissa tapauksissa kyselyhetkellä voimassa olevat tiedotteet.

Voit kokeilla esim. allaolevaa kyselyä GraphiQL-työkalussa osoitteessa https://rata-beta.digitraffic.fi/api/v2/graphql/graphiql

{
  passengerInformationMessages {
    audio {text {fi} deliveryRules {weekDays}}
    video {text {fi} deliveryRules {weekDays}}
    stations {station {name}}
    train {trainNumber departureDate}
  }
}

Onko sinulla toiveita tai kehitysehdotuksia rajapinnan suhteen? Kaikki kommentit ovat tervetulleita.

--

Hi,

passenger information messages are now available via the GraphQL API in Digitraffic's test environment. 

The stations and train related to a passenger information message may be linked to it. Any messages related to a train may also be linked to the train when querying for trains. At the moment the API returns currently active messages in each case.

You can try out for example the query found in the above Finnish language message using GraphiQL at https://rata-beta.digitraffic.fi/api/v2/graphql/graphiql

Leave a comment if you have any ideas or wishes regarding this API.


Ystävällisin terveisin / Best regards
– Digitraffic asiakastuki / Digitraffic support –

[Vili Ketonen]

Moi,

Olisiko mahdollista saada passengerInformationMessagesByStation-queryyn vastaavanlainen ònlyGeneral suodatin kuin REST-rajapinnassa: https://www.digitraffic.fi/rautatieliikenne/#voimassa-olevat-tiedotteet? Eli että voisi palauttaa vain aseman “yleiset” tiedotteet (jotka eivät liity tiettyyn junaan vaan ainoastaan annettuun asemaan).

- Vili

[rata.digitraffic.fi]

Terve,

kiitos hyvästä ehdotuksesta. Em. kyselyyn on nyt testipuolen rajapinnassa lisätty parametri onlyGeneral, joka toimii samoin kuin REST-puolella. Lisätty myös mahdollisuus liittää asemaan sitä koskevat tiedotteet (Station-tyypissä kenttä passengerInformationMessages). Uudet ominaisuudet viedään lähiaikoina tuotantorajapintaan.

Ystävällisin terveisin / Best regards
– Digitraffic asiakastuki / Digitraffic support –

[Vili Ketonen]

Moi,

Kiitos lisäyksestä. Yhden pienen tyyliseikan vielä huomasin: Sekä PassengerInformationAudioDeliveryRules että PassengerInformationVideoDeliveryRules -tyypeissä kenttä startTime on kirjoitettu camelCase:lla, mutta endtime ei ole. Tämän olisi varmaan tarkoitus olla endTime vastaavasti kuin startTime?

- Vili

[rata.digitraffic.fi]

Kyllä olisi, korjataan tämä. Kiitos taas hyvästä huomiosta!

Ystävällisin terveisin / Best regards
– Digitraffic asiakastuki / Digitraffic support –

[rata.digitraffic.fi]

Hei,

matkustajainformaation tiedotteet ovat saatavilla nyt myös tuotantoympäristön GraphQL-rajapinnassa.

Ohessa nykyinen GraphQL-skeema: https://rata.digitraffic.fi/api/v2/graphql/schema.svg

Ystävällisin terveisin / Best regards
– Digitraffic asiakastuki / Digitraffic support –

[rata.digitraffic.fi]

Hei,

GraphQL-rajapinnan skeemaan on tehty muutos matkustajainformaatioon liittyvien asemien osalta. Sekä asemista (Station) että matkustajainformaation viesteistä (PassengerInformationMessage) liitytään nyt tyyppiin PassengerInformationMessageStation:

type PassengerInformationMessageStation {

    stationShortCode: String!
    station: Station!
    message: PassengerInformationMessage!
    messageId: String!
    messageVersion: Int!

}

Tyypissä Station kenttä on stationMessages, tyypissä PassengerInformationMessage se on messageStations. Muutos oli kyselyjen suorituskyvyn kannalta välttämätön.

Ystävällisin terveisin / Best regards

– Digitraffic asiakastuki / Digitraffic support –