Game API: Difference between revisions

From SimRail Wiki
Jump to navigation Jump to search
No edit summary
Tag: Reverted
No edit summary
Tag: Reverted
Line 1: Line 1:
[[File:Api pngegg.png|thumb|300x300pixel|API logo, source pngegg.com]]
[[File:Api pngegg.png|thumb|300x300pixel|Logotipo API. Fuente: pngegg.com]]
==API Horario del tren==
==API Horario del tren==
Esta API recupera los horarios de los trenes correspondientes al número de tren especificado por el maquinista.
Esta API recupera los horarios de los trenes correspondientes al número de tren especificado por el maquinista.

Revision as of 13:23, 27 March 2023

Logotipo API. Fuente: pngegg.com

API Horario del tren

Esta API recupera los horarios de los trenes correspondientes al número de tren especificado por el maquinista.

Fuente

De momento, secreta.

https://staging.simrail.deadlykungfu.ninja/train/40684

Respuesta

Devolverá una matriz de la fila TrainTimetableRow

[
  {
    "train_number": "40684",
    "scheduled_arrival_hour": null,
    "station": "Tychy Lodowisko",
    "layover": null,
    "scheduled_departure_hour": "17:26",
    "train_type": "ROJ",
    "line": "179",
    "cachedate": "2023-02-12T18:48:23.975Z",
    "stop_type": "ph",
    "hourSort": 0
  },
  {
    "train_number": "40684",
    "scheduled_arrival_hour": "17:27",
    "station": "Tychy Miasto",
    "layover": "0.0",
    "scheduled_departure_hour": "17:27",
    "train_type": "ROJ",
    "line": "179",
    "cachedate": "2023-02-12T18:48:24.000Z",
    "stop_type": null,
    "hourSort": 1727
  }
]

Fila Horario

Campo Tipo Descripción
Train number variable El número del tren
scheduled_arrival_hour variable / nulo La hora de llegada del tren a la estación
Station variable El nombre de la estación
Layover variable / nulo Tiempo de la parada en minutos si el tren se detiene en esta estación.
Line variable La ía por la que ese tren accederá a la estación.
cachedate variable Hora en la que se actualizaron estos datos por última vez.
stop_type variable / nulo Si hay una parada en la estación, el tipo de escala. ph o pt
hourSort numérico Hora (en formato HHmm) para ayudar a ordenar los datos o centrarse en la estación actual.

Horarios del puesto de Control

Esta API recuperará el cuadro horario del puesto de Control.

Fuente: EDR oficial

Parámetros

Uno de los identificadores de Puesto (Post id): BZ LZ_LC SG_R52 son los únicos admitidos durante la recopilación

Solicitud

https://staging.simrail.deadlykungfu.ninja/dispatch/BZ

Respuesta

La respuesta será un ajuste de la fila StationTimetableRow

/!\ El cuadro horario del EDR oficial tiene un error según el cual algunos horarios de salida de los trenes difieren en 1 minuto entre el puesto de control y los datos del tren. Esto no supone un error de la API /!\.

[
  {
    "train_number": "14141",
    "train_type": "ECE",
    "type_speed": 0,
    "stop_type": null,
    "platform": " ",
    "arrival_time": "00:00",
    "departure_time": "00:00",
    "from_post": "Dąbrowa Górnicza",
    "to_post": "Sosnowiec Główny",
    "line": "1",
    "start_station": "Warszawa Grochów",
    "terminus_station": "Bohumin",
    "cachedate": "2023-02-12T18:08:32.837Z",
    "hourSort": 0
  },
  {
    "train_number": "41144",
    "train_type": "ECE",
    "type_speed": 0,
    "stop_type": null,
    "platform": " ",
    "arrival_time": "00:05",
    "departure_time": "00:05",
    "from_post": "Sosnowiec Główny",
    "to_post": "Dąbrowa Górnicza",
    "line": "1",
    "start_station": "Bohumin Vrbice",
    "terminus_station": "Warszawa Grochów",
    "cachedate": "2023-02-12T18:08:32.859Z",
    "hourSort": 5
  }
]

Fila Horario de la estación

Contenido de cada elemento de la matriz:

Campo Tipe Descripción
train_number variable El número del tren
train_type variable El tipo de tren
type_speed numérico / indefinido La velocidad máxima para el tipo de tren (si disponemos de dicha información).
platform variable El andén en que se detendrá el tren, por ejemplo I 1
arrival_time variable Hora de llegada prevista del tren.
departure_time variable Hora de salida del tren.
from_post variable Estación de procedencia del tren.
to_post variable Estación hacia la que se dirige el tren.
line variable La vía por la que se debe enviar el tren.
start_station variable La estación origen del tren.
terminus_station variable La estación término del tren.
cachedate variable La última vez que se actualizaron los datos desde la fuente.
hourSort numérico Valor de clasificación de carácter interno, que también puede ayudar a enfocar la fila actual.

Perfiles de Steam (Steam profiles)

Devuelve el nombre de usuario y el avatarUrl de un usuario determinado sin llamar a la API de SimRail y la mantiene en caché durante un día.

Solicitud

https://staging.simrail.deadlykungfu.ninja/steam/<steam_id>

Respuesta

Una matriz que contiene un elemento con sus datos.

[
  {
    "avatar": "https://avatars.akamai.steamstatic.com/70845eef7475441ffc0c9f9685cf40a57df07e15.jpg",
    "pseudo": "Someone"
  }
]

Información del tren por el Servidor

n/a

Autor: DeadlyKungFu.Ninja

Sitio Web: http://docs.simrail.deadlykungfu.ninja/