Agregados varios //TODO para revisar

2025-12-04 21:22:05 +01:00
parent e0133d2ca2
commit ec57ac366d
9 changed files with 837 additions and 118 deletions
--- a/API_DOCUMENTATION.md
+++ b/API_DOCUMENTATION.md
@@ -72,6 +72,16 @@ Body:
 POST /portroyalmanager/secure/stationsobservations/
 Base: https://estaciones.api.adif.es
 Headers: User-key para estaciones
+
+Body:
+{
+  "stationCodes": ["string"]  // Array de códigos de estación (requerido)
+}
+
+Ejemplo:
+{
+  "stationCodes": ["60000", "71801"]
+}
 ```

 ### Circulaciones (Trenes)
@@ -84,16 +94,28 @@ Headers: User-key para circulaciones

 Body:
 {
-  "commercialService": "YES|NO|ALL",
-  "commercialStopType": "YES|NO|ALL",
-  "destinationStationCode": "string|null",
-  "originStationCode": "string|null",
+  "commercialService": "YES|NOT|BOTH",      // Estado del servicio comercial
+  "commercialStopType": "YES|NOT|BOTH",     // Tipo de parada comercial
+  "destinationStationCode": "string|null",  // Código estación destino (opcional)
+  "originStationCode": "string|null",       // Código estación origen (opcional)
  "page": {
-    "page": number,
-    "size": number
+    "pageNumber": number                     // Número de página
  },
-  "stationCode": "string|null",
-  "trafficType": "CERCANIAS|MEDIA_DISTANCIA|LARGA_DISTANCIA|ALL"
+  "stationCode": "string|null",             // Código estación (opcional)
+  "trafficType": "CERCANIAS|AVLDMD|OTHERS|TRAVELERS|GOODS|ALL"  // Tipo de tráfico
+}
+
+Ejemplo:
+{
+  "commercialService": "BOTH",
+  "commercialStopType": "BOTH",
+  "destinationStationCode": null,
+  "originStationCode": null,
+  "page": {
+    "pageNumber": 0
+  },
+  "stationCode": "60000",
+  "trafficType": "ALL"
 }
 ```

@@ -102,7 +124,8 @@ Body:
 POST /portroyalmanager/secure/circulationpaths/arrivals/traffictype/
 Base: https://circulacion.api.adif.es
 Headers: User-key para circulaciones
-Body: Same as departures
+
+Body: Mismo formato que departures (TrafficCirculationPathRequest)
 ```

 #### Entre estaciones
@@ -110,7 +133,8 @@ Body: Same as departures
 POST /portroyalmanager/secure/circulationpaths/betweenstations/traffictype/
 Base: https://circulacion.api.adif.es
 Headers: User-key para circulaciones
-Body: Same as departures
+
+Body: Mismo formato que departures (TrafficCirculationPathRequest)
 ```

 #### Una ruta específica
@@ -121,11 +145,20 @@ Headers: User-key para circulaciones

 Body:
 {
-  "allControlPoints": boolean|null,
-  "commercialNumber": "string|null",
-  "destinationStationCode": "string|null",
-  "launchingDate": timestamp|null,
-  "originStationCode": "string|null"
+  "allControlPoints": boolean|null,        // Todos los puntos de control (opcional)
+  "commercialNumber": "string|null",       // Número comercial del tren (opcional)
+  "destinationStationCode": "string|null", // Código estación destino (opcional)
+  "launchingDate": number|null,            // Fecha de lanzamiento en timestamp (Long) (opcional)
+  "originStationCode": "string|null"       // Código estación origen (opcional)
+}
+
+Ejemplo:
+{
+  "allControlPoints": true,
+  "commercialNumber": "04138",
+  "destinationStationCode": "60000",
+  "launchingDate": 1733356800000,
+  "originStationCode": "71801"
 }
 ```

@@ -134,7 +167,8 @@ Body:
 POST /portroyalmanager/secure/circulationpathdetails/severalpaths/
 Base: https://circulacion.api.adif.es
 Headers: User-key para circulaciones
-Body: Same as onepaths
+
+Body: Mismo formato que onepaths (OneOrSeveralPathsRequest)
 ```

 ### Composiciones
@@ -215,20 +249,21 @@ Headers: Basic auth + X-CanalMovil headers

 ### TrafficType (Tipos de tráfico)
 - `CERCANIAS` - Trenes de cercanías
- `MEDIA_DISTANCIA` - Media distancia
- `LARGA_DISTANCIA` - Larga distancia
+- `AVLDMD` - Alta Velocidad, Larga y Media Distancia
+- `OTHERS` - Otros tipos de tráfico
+- `TRAVELERS` - Viajeros
+- `GOODS` - Mercancías
 - `ALL` - Todos los tipos

-### State (Estados)
+### State (Estados para comercialService y comercialStopType)
 - `YES` - Sí
- `NO` - No
- `ALL` - Todos
+- `NOT` - No
+- `BOTH` - Ambos

 ### PageInfoDTO
 ```json
 {
-  "page": 0,
-  "size": 20
+  "pageNumber": 0
 }
 ```

@@ -239,9 +274,13 @@ Headers: Basic auth + X-CanalMovil headers
 - Las User-keys son diferentes para cada servicio (estaciones vs circulaciones)
 - El token de registro `b9034774-c6e4-4663-a1a8-74bf7102651b` está en el código

-[CODE] 200
-[METHOD] POST
-[URL] https://circulacion.api.adif.es/portroyalmanager/secure/circulationpathdetails/onepaths/
-[URL] https://circulacion.api.adif.es/portroyalmanager/secure/circulationpaths/betweenstations/traffictype/
-[URL] https://circulacion.api.adif.es/portroyalmanager/secure/circulationpaths/departures/traffictype/
-[URL] https://estaciones.api.adif.es/portroyalmanager/secure/stationsobservations/
+## Notas de Implementación
+
+Esta documentación se ha obtenido mediante ingeniería reversa del código decompilado de la aplicación Android de ADIF Elcano.
+
+Clases principales analizadas:
+- `com.adif.elcanomovil.serviceNetworking.circulations.model.request.TrafficCirculationPathRequest`
+- `com.adif.elcanomovil.serviceNetworking.circulations.model.request.OneOrSeveralPathsRequest`
+- `com.adif.elcanomovil.serviceNetworking.stationObservations.model.StationObservationsRequest`
+- `com.adif.elcanomovil.serviceNetworking.circulations.model.request.CirculationPathRequest` (interface)
+- `com.adif.elcanomovil.serviceNetworking.circulations.model.request.TrafficType` (enum)