# Aan de slag

## 1 · Haal een NS API-key op

Reisdata leeft achter het [NS API Developer Portal](https://apiportal.ns.nl/) en je hebt een persoonlijke subscription key nodig om er bij te kunnen. De key is **gratis**.

De volledige klik-voor-klik handleiding heeft een eigen pagina:

{% content-ref url="/pages/k5Ve5LWmsMgYMcFxJaYh" %}
[Je NS API-key ophalen](/docs-nl/handleidingen/ns-api-key.md)
{% endcontent-ref %}

In het kort: registreer op apiportal.ns.nl, abonneer op het **Ns-App** product, en kopieer de **primary key** uit je profiel. Kom hier terug zodra je de key op je klembord hebt.

## 2 · Installeer de app en plak de key

1. Installeer de NS-app op je Homey.
2. Open in de Homey-app de NS-app en tik op **App configureren**.
3. Plak je subscription key in het **API key**-veld.
4. Tik op **Verbinding testen**. Je zou een groen succesbericht moeten zien.

Lukt de test niet, controleer dan dat je de **primary** key hebt gekopieerd (niet de secondary), en dat je daadwerkelijk geabonneerd bent op het Ns-App product — zonder subscription werkt de key niet.

## 3 · Koppel je eerste apparaat

De app heeft twee apparaattypes — kies welke past bij wat je wilt automatiseren.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Station</strong></td><td>Volg alle vertrekken vanaf één station, eventueel gefilterd op bestemming.</td><td><a href="/pages/zU7wRH5yPK9YlqGi5Qyj">/pages/zU7wRH5yPK9YlqGi5Qyj</a></td></tr><tr><td><strong>Traject</strong></td><td>Volg één A→B-route. Gebruik dit voor je dagelijkse woon-werk-traject.</td><td><a href="/pages/ct7NDA9lKtAcIPziz7Ke">/pages/ct7NDA9lKtAcIPziz7Ke</a></td></tr></tbody></table>

In Homey: **Apparaten → Apparaat toevoegen → NS → \[Station of Traject]**.

## 4 · Bouw je eerste flow

Een suggestie om mee te beginnen: krijg een melding als je trein naar huis vertraagd is.

**Wanneer**: *Volgende trein vertraagd met meer dan \[10] minuten* (Trajectapparaat) **Dan**: *Stuur pushbericht: "Volgende trein om {{departure\_time}} is +{{delay\_minutes}} min"*

Zie [flowkaarten](/docs-nl/naslag/flow-cards.md) voor alles wat beschikbaar is.

## 5 · Stem het ververs-interval af (optioneel)

Elk apparaat heeft een **Verversingsinterval**-instelling:

* **Station** — standaard 60 s, minimum 60 s.
* **Traject** — standaard 120 s, minimum 120 s.

Lager betekent verser data en meer API-calls; de minima houden je veilig binnen typische NS API-quota. Zie de [rate limits-handleiding](/docs-nl/handleidingen/rate-limits.md) voor de afweging.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://homey-nederlandse-spoorwegen.gitbook.io/docs-nl/handleidingen/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.