# Programar ruta OnBus - programRouteOnBus

##### <span class="api-method" data-method="POST">POST</span> https://api.service24gps.com/api/v1/programRouteOnBus

Programa la salida de una ruta para el sistema OnBus.

<details class="mb-m" id="bkmrk-body-parametersparam"><summary class="text-muted">Ver parámetros de solicitud:</summary>

<div><table class="table" style="height: 269px;"><tbody><tr><td style="width: 121px;">**Parámetros**</td><td style="width: 360px;">**Descripción**</td><td style="width: 328px;"><span style="color: #000000;">**<span role="presentation" style="padding-right: 0.1px;">Ejemplo</span>**</span></td></tr><tr style="height: 57px;"><td style="width: 121px; height: 57px;">apikey</td><td style="width: 360px; height: 57px;">Llave de autorización para uso de los Servicios Web.</td><td style="width: 328px; height: 57px;"><span role="presentation" style="padding-right: 0.1px; color: #3366ff;">25sdsd234234aa93sdsdsd37c70118e72</span></td></tr><tr style="height: 41px;"><td style="width: 121px; height: 41px;">token</td><td style="width: 360px; height: 41px;">Token devuelto por el método getToken.</td><td style="width: 328px; height: 41px;"><span style="color: #3366ff;">wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==</span></td></tr><tr><td style="width: 121px;">idruta

</td><td style="width: 360px;">Identificador único de la ruta que se va a utilizar para la programación de salida de ruta.

</td><td style="width: 328px;"><span style="color: #3366ff;"> 2533</span></td></tr><tr><td style="width: 121px;">idactivo

</td><td style="width: 360px;">Identificador único del activo que realizará el recorrido de la ruta seleccionada.

</td><td style="width: 328px;"><span style="color: #3366ff;">13953 </span></td></tr><tr><td style="width: 121px;">nombre

</td><td style="width: 360px;">Nombre asignado a la ruta programada

</td><td style="width: 328px;"><span style="color: #3366ff;">OnBus APII </span></td></tr><tr><td style="width: 121px;">definicion

</td><td style="width: 360px;">Definición de los puntos

</td><td style="width: 328px;"><span style="color: #3366ff;">{</span>  
<span style="color: #3366ff;"> "distancia":"80",</span>  
<span style="color: #3366ff;"> "frecuenciaSalida":"10",</span>  
<span style="color: #3366ff;"> "lugares":\[</span>  
<span style="color: #3366ff;"> {</span>  
<span style="color: #3366ff;"> "id":"11789",</span>  
<span style="color: #3366ff;"> "tipo":"2",</span>  
<span style="color: #3366ff;"> "orden":"1",</span>  
<span style="color: #3366ff;"> "nombre":"TERMINAL BOGOTA",</span>  
<span style="color: #3366ff;"> "dist\_pa":"0",</span>  
<span style="color: #3366ff;"> "latLng":"4.611841,-74.17858",</span>  
<span style="color: #3366ff;"> "fEstimada":"",</span>  
<span style="color: #3366ff;"> "timeBetween":"0",</span>  
<span style="color: #3366ff;"> "distLleg":"500",</span>  
<span style="color: #3366ff;"> "orientacion":"",</span>  
<span style="color: #3366ff;"> "salidaEstimada":"2018-05-05 18:01:18"</span>  
<span style="color: #3366ff;"> }</span>  
<span style="color: #3366ff;">\],</span>  
<span style="color: #3366ff;">"conductor1":\[</span>  
<span style="color: #3366ff;"> {</span>  
<span style="color: #3366ff;"> "id":2300,</span>  
<span style="color: #3366ff;"> "codigo":"KS8374",</span>  
<span style="color: #3366ff;"> "nombre":"Karla Segovia"</span>  
<span style="color: #3366ff;"> }</span>  
<span style="color: #3366ff;">\],</span>  
<span style="color: #3366ff;">"conductor2":\[</span>  
<span style="color: #3366ff;"> {</span>  
<span style="color: #3366ff;"> "id":2297,</span>  
<span style="color: #3366ff;"> "codigo":"CM5732",</span>  
<span style="color: #3366ff;"> "nombre":"Luis Morales"</span>  
<span style="color: #3366ff;"> }</span>  
<span style="color: #3366ff;">\],</span>  
<span style="color: #3366ff;">"creado":"2021-05-05 18:01:18"</span>  
<span style="color: #3366ff;">}</span></td></tr><tr><td style="width: 121px;">fecha\_inicio

</td><td style="width: 360px;">Fecha en la que deberá iniciar la salida de ruta

</td><td style="width: 328px;"><span style="color: #3366ff;"> 2021-05-05</span></td></tr><tr><td style="width: 121px;">hora\_inicio

</td><td style="width: 360px;">Hora en la que deberá iniciar la salida de ruta

</td><td style="width: 328px;"><span style="color: #3366ff;">17:00:00 </span></td></tr><tr><td style="width: 121px;">fecha\_fin

</td><td style="width: 360px;">Fecha en la que finalizará la ruta (se debe enviar vacío en caso de no utilizarlo)

</td><td style="width: 328px;"><span style="color: #3366ff;"> 2021-05-05</span></td></tr><tr><td style="width: 121px;">hora\_fin

</td><td style="width: 360px;">Hora en la que finalizará la ruta (se debe enviar vacío en caso de no utilizarlo)

</td><td style="width: 328px;"><span style="color: #3366ff;"> 19:50:00</span></td></tr></tbody></table>

</div></details>##### Solicitud de ejemplo:

```shell
curl --location --request POST 'https://api.service24gps.com/api/v1/programRouteOnBus' \
--header 'Cookie: PHPSESSID=0ab8djc97ouk13tev2t9epf1l2' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'idruta="2533"' \
--form 'idactivo="13953"' \
--form 'nombre="OnBus APII"' \
--form 'definicion="{\"distancia\":\"80\",\"frecuenciaSalida\":\"10\",\"lugares\":[{\"id\":\"11789\",\"tipo\":\"2\",\"orden\":\"1\",\"nombre\":\"TERMINAL BOGOTA\",\"dist_pa\":\"0\",\"latLng\":\"4.653657365711841,-74.1157141327858\",\"fEstimada\":\"\",\"timeBetween\":\"0\",\"distLleg\":\"500\",\"orientacion\":\"\",\"salidaEstimada\":\"2018-05-05 18:01:18\"}],\"conductor1\":[{\"id\":2300,\"codigo\":\"KS8374\",\"nombre\":\"Karla Segovia\"}],\"conductor2\":[{\"id\":2297,\"codigo\":\"CM5732\",\"nombre\":\"Luis Morales\"}],\"creado\":\"2021-05-05 18:01:18\"}"' \
--form 'fecha_inicio="2021-05-05"' \
--form 'hora_inicio="17:00:00"' \
--form 'fecha_fin="2021-05-05"' \
--form 'hora_fin="19:50:00"'
```

##### Respuesta de ejemplo:

```JSON
{
    "status": 200,
    "data": {
        "id": "2080129"
    }
}
```