Update nederlandse_spoorwegen.markdown

[YarmoM]

Description:
The NS API has recently changed and this documentation update reflects the changes made in the component codebase.

Pull request in home-assistant (if applicable): home-assistant/core#30599

Checklist:

• Branch: next is for changes and new documentation that will go public with the next Home Assistant release. Fixes, changes and adjustments for the current release should be created against current.
• The documentation follows the standards.

[frenck]

✅ Approved. Can be merged as soon as the parent PR gets merged.

[YarmoM]

Thanks for the tweak and your time reviewing this PR!

[kevintuhumury]

@YarmoM the API you mentioned in this PR might be outdated before this gets merged into master. You mentioned that the RetrieveTripInformationPublicAPI API should be used. Looking at the corresponding page it mentions the following:

Per the 31st of january only the price API will be available here. Please go to the Ns app Product on this website for using the other API's that are available. Only the Price API will work after the 31st of january!

Source: https://apiportal.ns.nl/products/PublicNsApi

So, I'm not sure whether or not this is going to work after that date. Just thought I'd mention this.

[YarmoM]

@kevintuhumury Thanks a bunch for mentioning this! I hadn't realized this change was about to happen.

So for my understanding, I need to point to "NS app" product and then "Reisinformatie" API?

[kevintuhumury]

@YarmoM I'm not completely sure. I haven't looked into the API's themselves. I was going through your updated documentation as I want to use the integration myself. So, I went to the API portal and noticed the mention of them closing the API.

It does look like you should use the 'NS app' product, but I'm unsure whether the 'Reisinformatie' API provides the same or more data.