Nederlandse Spoorwegen (Editor Independente) (versão prévia)
Recupere informações do principal operador ferroviário holandês.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Miguel Verweij |
| URL | https://www.powerplatformchallenge.com |
| miguel.verweij@powerbouwer.com |
| Metadados do conector | |
|---|---|
| Publicador | Miguel Verweij |
| Site | https://apiportal.ns.nl/ |
| Política de privacidade | https://www.ns.nl/en/privacy |
| Categorias | Dados |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de API emitida por Nederlandse Spoorwegen. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Chegadas |
Lista de chegadas para uma estação específica. |
| Interrupções na estação |
Lista de interrupções relevantes para uma estação. |
| Partidas |
Lista de partidas para uma estação específica. |
| Stations |
Lista de estações. |
Chegadas
Lista de chegadas para uma estação específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Linguagem
|
lang | string |
Idioma a ser usado para localizar a lista de chegadas. Somente um pequeno subconjunto de texto é traduzido. O padrão é holandês. |
|
|
Código da estação
|
station | string |
Código da Estação NS para a qual a estação retornará as chegadas. Pode ser deixado vazio se o parâmetro UIC Code for fornecido. |
|
|
Código UIC
|
uicCode | string |
Código UIC para o qual a estação retornará as chegadas. Pode ser deixado vazio se o parâmetro Station Code for fornecido. |
|
|
Data e Hora
|
dateTime | string |
Data de partida para mostrar chegadas de RFC3339 formato. Só há suporte para chegadas em estações estrangeiras. Padrões para o tempo de servidor (Europa/Amsterdã) |
|
|
Chegadas máximas
|
maxJourneys | integer |
Número de chegadas a serem retornadas. O padrão é 40. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Source
|
payload.source | string |
Origem da resposta. |
|
Chegadas
|
payload.arrivals | array of object |
Chegadas |
|
Origin
|
payload.arrivals.origin | string |
Estação de origem do trem que chega. |
|
Nome
|
payload.arrivals.name | string |
Nome do trem que chega. |
|
Hora da Data Planejada
|
payload.arrivals.plannedDateTime | string |
Hora da data planejada do trem que chega. |
|
Deslocamento de fuso horário planejado
|
payload.arrivals.plannedTimeZoneOffset | integer |
Deslocamento de fuso horário planejado do trem que chega. |
|
Hora da Data Real
|
payload.arrivals.actualDateTime | string |
Hora da data real. |
|
Deslocamento de fuso horário real
|
payload.arrivals.actualTimeZoneOffset | integer |
Deslocamento de fuso horário do tempo real. |
|
Faixa Planejada
|
payload.arrivals.plannedTrack | string |
Pista planejada do trem que chega. |
|
Número do Trem
|
payload.arrivals.product.number | string |
Número do trem que chega. |
|
Código de categoria
|
payload.arrivals.product.categoryCode | string |
Código de categoria do trem que chega. |
|
Nome da Categoria Curta
|
payload.arrivals.product.shortCategoryName | string |
Nome da categoria curta do trem que chega. |
|
Nome da categoria longa
|
payload.arrivals.product.longCategoryName | string |
Nome da categoria longa do trem que chega. |
|
Código do operador
|
payload.arrivals.product.operatorCode | string |
Código do operador do trem que chega. |
|
Nome do operador
|
payload.arrivals.product.operatorName | string |
Nome do operador do trem que chega. |
|
Categoria de Treinamento
|
payload.arrivals.trainCategory | string |
Categoria do trem que chega. |
|
Cancelado
|
payload.arrivals.cancelled | boolean |
Booliano indicando se o trem foi cancelado. |
|
messages
|
payload.arrivals.messages | array of object |
messages |
|
mensagem
|
payload.arrivals.messages.message | string |
mensagem |
|
estilo
|
payload.arrivals.messages.style | string |
estilo |
|
Status de Chegada
|
payload.arrivals.arrivalStatus | string |
Status de chegada do trem. |
|
Controle Real
|
payload.arrivals.actualTrack | string |
Controle real da chegada. |
Interrupções na estação
Lista de interrupções relevantes para uma estação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código da estação
|
stationCode | True | string |
Código da Estação NS da estação para a qual retornar interrupções. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID
|
id | string |
ID da interrupção. |
|
Tipo de seção Título
|
type | string |
Tipo da seção de título para comunicação de interrupções. |
|
Tempo de Registro
|
registrationTime | string |
Data e hora em que a interrupção é registrada. |
|
Hora da versão
|
releaseTime | string |
Data e hora em que a interrupção é liberada. |
|
Local
|
local | boolean |
Booliano indicando se a interrupção é local. |
|
Title
|
title | string |
Título da interrupção. |
|
titleSections
|
titleSections | array of array |
titleSections |
|
items
|
titleSections | array of object | |
|
tipo
|
titleSections.type | string |
tipo |
|
value
|
titleSections.value | string |
value |
|
Está ativo
|
isActive | boolean |
Booliano indicando se a discrupção está ativa. |
|
Start
|
start | string |
Início da interrupção. |
|
participante
|
end | string |
Fim da interrupção. |
|
Período
|
period | string |
Período da interrupção. |
|
Valor da seção Título
|
impact.value | integer |
Valor da seção de título para comunicação de interrupções. |
|
publicationSections
|
publicationSections | array of object |
publicationSections |
|
Estações
|
publicationSections.section.stations | array of object |
Estações |
|
uicCode
|
publicationSections.section.stations.uicCode | string |
uicCode |
|
stationCode
|
publicationSections.section.stations.stationCode | string |
stationCode |
|
nome
|
publicationSections.section.stations.name | string |
nome |
|
lat
|
publicationSections.section.stations.coordinate.lat | float |
lat |
|
Gnl
|
publicationSections.section.stations.coordinate.lng | float |
Gnl |
|
código do país
|
publicationSections.section.stations.countryCode | string |
código do país |
|
direção
|
publicationSections.section.direction | string |
direção |
|
Estações
|
publicationSections.consequence.section.stations | array of object |
Estações |
|
uicCode
|
publicationSections.consequence.section.stations.uicCode | string |
uicCode |
|
stationCode
|
publicationSections.consequence.section.stations.stationCode | string |
stationCode |
|
nome
|
publicationSections.consequence.section.stations.name | string |
nome |
|
lat
|
publicationSections.consequence.section.stations.coordinate.lat | float |
lat |
|
Gnl
|
publicationSections.consequence.section.stations.coordinate.lng | float |
Gnl |
|
código do país
|
publicationSections.consequence.section.stations.countryCode | string |
código do país |
|
direção
|
publicationSections.consequence.section.direction | string |
direção |
|
descrição
|
publicationSections.consequence.description | string |
descrição |
|
nível
|
publicationSections.consequence.level | string |
nível |
|
sectionType
|
publicationSections.sectionType | string |
sectionType |
|
timespans
|
timespans | array of object |
timespans |
|
start
|
timespans.start | string |
start |
|
término
|
timespans.end | string |
término |
|
period
|
timespans.period | string |
period |
|
etiqueta
|
timespans.situation.label | string |
etiqueta |
|
etiqueta
|
timespans.cause.label | string |
etiqueta |
|
Conselhos
|
timespans.advices | array of string |
Conselhos |
|
alternativeTransportTimespans
|
alternativeTransportTimespans | array of |
alternativeTransportTimespans |
Partidas
Lista de partidas para uma estação específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Linguagem
|
lang | string |
Idioma a ser usado para localizar a lista de saídas. Somente um pequeno subconjunto de texto é traduzido, principalmente anotações. Padrões para holandês |
|
|
Código da estação
|
station | string |
Código da Estação NS para a qual a estação retornará as partidas. Pode ser deixado vazio se o parâmetro UIC Code for fornecido. |
|
|
Código UIC
|
uicCode | string |
Código UIC para o qual a estação retornará as partidas. Pode ser deixado vazio se o parâmetro Station Code for fornecido. |
|
|
Data e Hora
|
dateTime | string |
Data de partida para mostrar saídas de RFC3339 formato. Só há suporte para partidas em estações estrangeiras. O padrão é o tempo de servidor (Europa/Amsterdã). |
|
|
Saídas máximas
|
maxJourneys | string |
Número de partidas a serem retornadas. O padrão é 40 |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Source
|
payload.source | string |
Origem da resposta. |
|
Partidas
|
payload.departures | array of object |
Partidas |
|
Direção
|
payload.departures.direction | string |
Direção do trem de partida. |
|
Nome
|
payload.departures.name | string |
Nome do trem de partida. |
|
Hora da Data Planejada
|
payload.departures.plannedDateTime | string |
Hora de data planejada do trem de partida. |
|
Deslocamento de fuso horário planejado
|
payload.departures.plannedTimeZoneOffset | integer |
Deslocamento de fuso horário planejado do trem de partida. |
|
Hora da Data Real
|
payload.departures.actualDateTime | string |
Hora da data real. |
|
Deslocamento de fuso horário real
|
payload.departures.actualTimeZoneOffset | integer |
Deslocamento de fuso horário do tempo real. |
|
Faixa Planejada
|
payload.departures.plannedTrack | string |
Pista planejada do trem que chega. |
|
Número do Trem
|
payload.departures.product.number | string |
Número do trem de partida. |
|
Código de categoria
|
payload.departures.product.categoryCode | string |
Código de categoria do trem de partida. |
|
Nome da Categoria Curta
|
payload.departures.product.shortCategoryName | string |
Nome da categoria curta do trem de partida. |
|
Nome da categoria longa
|
payload.departures.product.longCategoryName | string |
Nome da categoria longa do trem de partida. |
|
Código do operador
|
payload.departures.product.operatorCode | string |
Código do operador do trem de partida. |
|
Nome do operador
|
payload.departures.product.operatorName | string |
Nome do operador do trem de partida. |
|
Tipo
|
payload.departures.product.type | string |
Tipo do trem de partida. |
|
Categoria de Treinamento
|
payload.departures.trainCategory | string |
Categoria do trem de partida. |
|
Cancelado
|
payload.departures.cancelled | boolean |
Booliano indicando se o trem foi cancelado. |
|
routeStations
|
payload.departures.routeStations | array of object |
routeStations |
|
uicCode
|
payload.departures.routeStations.uicCode | string |
uicCode |
|
mediumName
|
payload.departures.routeStations.mediumName | string |
mediumName |
|
messages
|
payload.departures.messages | array of |
messages |
|
Status da partida
|
payload.departures.departureStatus | string |
Status de partida do trem. |
Stations
Lista de estações.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
conteúdo
|
payload | array of object |
conteúdo |
|
Código UIC
|
payload.UICCode | string |
Código UIC da estação. |
|
Tipo de estação
|
payload.stationType | string |
Tipo da estação. |
|
Código EVA
|
payload.EVACode | string |
Código EVA da estação. |
|
Código da estação
|
payload.code | string |
Código da estação. |
|
esporen
|
payload.sporen | array of object |
esporen |
|
spoorNummer
|
payload.sporen.spoorNummer | string |
spoorNummer |
|
sinônimos
|
payload.synoniemen | array of string |
sinônimos |
|
Tem instalações
|
payload.heeftFaciliteiten | boolean |
Booliano indicando se a estação tem instalações. |
|
Tem Horários de Partida
|
payload.heeftVertrektijden | boolean |
Booliano indicando se a estação tem tempo de partida. |
|
Tem Assistência de Viagem
|
payload.heeftReisassistentie | boolean |
Booliano indicando se a estação tem assistência de viagem. |
|
Nome Completo
|
payload.namen.lang | string |
Nome completo da estação. |
|
Nome Curto
|
payload.namen.kort | string |
Nome curto da estação. |
|
País
|
payload.land | string |
Código do condado da estação. |
|
Latitude
|
payload.lat | float |
Latitude da estação. |
|
Longitude
|
payload.lng | float |
Longitude da estação. |
|
Raio
|
payload.radius | integer |
Raio da estação. |
|
Raio de Abordagem
|
payload.naderenRadius | integer |
Raio de aproximação da estação. |