Dokumentaatio: api/port-call/v1/vessel-details ja "all"

[Stormwind]

Sivulla

https://meri.digitraffic.fi/swagger/#/AIS%20V1/allVessels 

löytyy otsikko 

/api/port-call/v1/vessel-details

jonka alla on ko. haun schma.

Alempana näkyy korrektisti ensin avaimet (eri järjestyksessä kuin alla, jonka sain Http-kutsulla):

(dataSource imoLloyds mmsi name namePrefix radioCallSign radioCallSignType updateTimestamp vesselId)

sekä ne joilla on seuraavan (JSON)tason sisältöä:

(vesselConstruction vesselDimensions vesselRegistration vesselSystem)

Hämmennystä tuo se, että ko. dokumentaationssa on vielä yksi avain, avain, "all" - koska sen alla samat avaimet + sama hierarkia toistuu uudemman kerran, ja jälleen loppuu avaimeen "all" - jonka alla jälleen sama toistuu ja loppuu avaimeen "all" - joka toistuu, jne.

Seurasin tuota selaimessa (Firefox) syvyyteen 50, ja vielä tuntui jatkuvan.

Mikä mahtaa olla logiikka tuossa? Näyttäisi rekursiolta, mutta onkohan se tahallinen?

Avain "all" ei näyttäisi palautuvan Http-kutsulla olleenkaan, esim:

https://meri.digitraffic.fi/api/port-call/v1/vessel-details?mmsi=229025000

[meri.digitraffic.fi]

Hei

Kiitos viestistä.  Tässä näyttäisi olevan bugi dokumentaation generoinnissa, teen tästä meille tiketin ja korjailemme tuon ylimääräisen avaimen tuolta pois.

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