🚌 Bus Lines APIs_

Overview

The Bus Lines APIs provide access to partnered bus line data, including download links and detailed information about available bus routes.

Endpoints

Get All Partnered Lines

Endpoint: GET /lines

Retrieves a list of all partnered bus lines available for download.

Parameters: None

Response:

<code>{
  &quot;success&quot;: true,
  &quot;lines&quot;: [
    {
      &quot;id&quot;: 1,
      &quot;name&quot;: &quot;City Express Line 42&quot;,
      &quot;file_name&quot;: &quot;line_42_v1.0.zip&quot;,
      &quot;current_version&quot;: &quot;1.0&quot;,
      &quot;download_url&quot;: &quot;https://example.com/download/line_42.zip&quot;,
      &quot;company&quot;: {
        &quot;id&quot;: 456,
        &quot;name&quot;: &quot;City Transport Company&quot;
      },
      &quot;partnered&quot;: true,
      &quot;created_at&quot;: &quot;2023-01-01T00:00:00Z&quot;,
      &quot;updated_at&quot;: &quot;2023-01-01T00:00:00Z&quot;
    }
  ]
}
</code>

Get Line Details

Endpoint: GET /lines/{lineId}

Retrieves detailed information about a specific bus line.

Parameters:

• lineId (path) - The line's ID

Response:

<code>{
  &quot;success&quot;: true,
  &quot;line&quot;: {
    &quot;id&quot;: 1,
    &quot;name&quot;: &quot;City Express Line 42&quot;,
    &quot;file_name&quot;: &quot;line_42_v1.0.zip&quot;,
    &quot;current_version&quot;: &quot;1.0&quot;,
    &quot;download_url&quot;: &quot;https://example.com/download/line_42.zip&quot;,
    &quot;company&quot;: {
      &quot;id&quot;: 456,
      &quot;name&quot;: &quot;City Transport Company&quot;
    },
    &quot;partnered&quot;: true,
    &quot;created_at&quot;: &quot;2023-01-01T00:00:00Z&quot;,
    &quot;updated_at&quot;: &quot;2023-01-01T00:00:00Z&quot;
  }
}
</code>

Error Responses:

• 404 - Line not found or not partnered

Line Properties

• id - Unique line identifier
• name - Line display name
• file_name - Download file name
• current_version - Current version number
• download_url - Direct download link
• company - Associated company information
• partnered - Whether the line is officially partnered
• created_at - When the line was created
• updated_at - When the line was last updated

Usage Notes

• Only partnered lines are accessible through the API
• Download URLs are direct links to the line files
• Lines are sorted alphabetically by name
• Company information includes the creating/owning company

← Back to API Documentation