Naantalin Sataman (FINLI) aluskäynti tiedoissa erikoisia aikaleimoja

[Tomi P]

Hei,

Huomasin juuri että haettaessa aluskäyntejä locodelle FINLI rajapinta palauttaa aina kaksi käyntiä, joilla on hieman erikoiset PortCallTimestampit:

Esimekkihaku

/api/port-call/v1/port-calls?from=2023-01-01T06%3A30%3A00.000Z&atdTo=2023-01-15T06%3A30%3A00.000Z&locode=FINLI

ja tuloksissa kaksi ensimmäistä "osumaa" on aina:

"portCallId": 2718246, "portCallTimestamp": "+10212-07-17T11:17:14.000+00:00", "customsReference": "2/200428999", "portCallId": 2894573, "portCallTimestamp": "9004-08-05T06:19:56.000+00:00", "customsReference": "2/200433734",
Voisiko nämä korjata suoraan lähtödataan tai joko estää rajapintaa palauttamasta ko. rivejä, koska ne tulevat aina mukaan, jos rajaa dataa aikaleimoilla ja tämä aiheuttaa sanomien käsittelyssä turhia virheilmoituksia ja säätämistä.

Terveisin,

Tomi Paasonen

[meri.digitraffic.fi]

Hei

Kiitos viestistäsi.  Selvitämme mistä nuo jännät aikaleimat ovat tulleet ja teemme sitten korjaukset.

Ystävällisin terveisin / Best regards

– Digitraffic asiakastuki / Digitraffic support –

[Tomi P]

Hei,

Onko tietoa koska nämä kaksi erikoista aikaleimaa korjattaisiin? Ilmiesesti nuo hämärät käynnit/aikaleimat sekoittavat tuota rajapintahakua muutenkin:

Locode FINLI palauttaa todella hämärää dataa, jos käyttää esim ata ja/tai atd aikoja rajaukseen. esim 2022 ei tule käynnin käyntiä ja vuodelle 2023 5 käyntiä

Esimerkki kutsu: 

https://meri.digitraffic.fi/api/port-call/v1/port-calls?atdFrom=2022-01-01T00%3A00%3A00.000Z&atdTo=2022-12-31T00%3A00%3A00.000Z&locode=FINLI

tämä ei palauta mitään ja jos vaihtaa vuoden 2023 niin tulee muutama käynti.

-Tomi-

[meri.digitraffic.fi]

Hei,

Ikävä kyllä meillä ei ole tapaa korjata näitä tietoja meidän päähän. Datalähteeseen ei tällä hetkellä tehdä mitään korjaavia muutoksia, joten joudumme elämään toisinaan huonon datan kanssa.

Atd-hakujen osalta vaikuttaisi bugilta meidän järjestelmässä. Toistaiseksi voit hakea from ja to -parametrien avulla tiedot ja suodattaa ohjelmallisesti tietueet, joissa ei ole atd-tietoa merkittynä.

Ystävällisin terveisin / Best regards

– Digitraffic asiakastuki / Digitraffic support –

[Tomi P]

Hei,

Asia selvä. Tosiaan ainoa Locode, jossa tätä sekoilua on tullut vastaan, on tuo FINLI eli muiden satamien atd haut toimivat näennäisesti moitteetta.

Ja ko. sekouilu käynnit tulevat mukaan aina hakee dataa FINLI:stä miten vain eli nekin pitää sieltä aina poimia pois :)

Kannattanee muokata tuota swagger kuvausta tuon aikaleiman osalta, niin ettei se ei ole käytännössä $date-time vaan string joka pitää manuaalisesti tarkistaa ja varmistaa että se on kelpo date-time.

portCallTimestamp string($date-time)
Port call information modification time

Jos rajapinnan käyttäjä luottaa tuohon kuvaukseen ja muuntaa saadun aineiston ohjelmallisesti/automaattisesti, tulee ongelmia, koska kyseinen kenttä joudutaan nyt käsittelemään erikseen ja varmistamaan että on validi date-time eikä joku aivan älytön arvo.

Vastauksen muuntaminen ns. automaattisesti haluttuun muotoon vaatii jatkossa siis turhia lisä tarkistuksia ja validointeja noiden täysin epävalidien aikaleimojen osalta. Mutta näiden kanssa tosiaan joudutaan elämään.

Toivottavasti Nemo aikanaan validoi paremmin sisältönsä kuin Portnet :)

-Tomi-