checkpoint5b44ca05 months ago175 lines · 9.6 KB | 1 | # openapi (EXPERIMENTAL) |
| 2 | Plane Pal API Documentation |
| 3 | |
| 4 | This Dart package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech |
| 5 | |
| 6 | - API version: 1.0.0 |
| 7 | - Generator version: 7.21.0 |
| 8 | - Build package: org.openapitools.codegen.languages.DartDioClientCodegen |
| 9 | |
| 10 | ## Requirements |
| 11 | |
| 12 | * Dart 2.15.0+ or Flutter 2.8.0+ |
| 13 | * Dio 5.0.0+ (https://pub.dev/packages/dio) |
| 14 | |
| 15 | ## Installation & Usage |
| 16 | |
| 17 | ### pub.dev |
| 18 | To use the package from [pub.dev](https://pub.dev |
| 19 | ```yaml |
| 20 | dependencies: |
| 21 | openapi: 1.0.0 |
| 22 | ``` |
| 23 | |
| 24 | ### Github |
| 25 | If this Dart package is published to Github, please include the following in pubspec.yaml |
| 26 | ```yaml |
| 27 | dependencies: |
| 28 | openapi: |
| 29 | git: |
| 30 | url: https://github.com/GIT_USER_ID/GIT_REPO_ID.git |
| 31 | #ref: main |
| 32 | ``` |
| 33 | |
| 34 | ### Local development |
| 35 | To use the package from your local drive, please include the following in pubspec.yaml |
| 36 | ```yaml |
| 37 | dependencies: |
| 38 | openapi: |
| 39 | path: /path/to/openapi |
| 40 | ``` |
| 41 | |
| 42 | ## Getting Started |
| 43 | |
| 44 | Please follow the [installation procedure](#installation--usage |
| 45 | |
| 46 | ```dart |
| 47 | import 'package:openapi/openapi.dart'; |
| 48 | |
| 49 | |
| 50 | final api = Openapi(). |
| 51 | final String search = search_example; |
| 52 | |
| 53 | try { |
| 54 | final response = await api. |
| 55 | print(response); |
| 56 | } on DioException catch (e) { |
| 57 | print("Exception when calling AirlinesApi->airlinesControllerGetAirlinesV1: $e\n |
| 58 | } |
| 59 | |
| 60 | ``` |
| 61 | |
| 62 | ## Documentation for API Endpoints |
| 63 | |
| 64 | All URIs are relative to *http://localhost* |
| 65 | |
| 66 | Class | Method | HTTP request | Description |
| 67 | ------------ | ------------- | ------------- | ------------- |
| 68 | [*AirlinesApi*]( |
| 69 | [*AirportsApi*]( |
| 70 | [*AppApi*]( |
| 71 | [*AuthenticationApi*]( |
| 72 | [*AuthenticationApi*]( |
| 73 | [*AuthenticationApi*]( |
| 74 | [*FlightApi*]( |
| 75 | [*FlightApi*]( |
| 76 | [*FlightApi*]( |
| 77 | [*FlightApi*]( |
| 78 | [*FlightApi*]( |
| 79 | [*FlightApi*]( |
| 80 | [*FlightApi*]( |
| 81 | [*FlightApi*]( |
| 82 | [*FlightAlertsApi*]( |
| 83 | [*FlightAlertsApi*]( |
| 84 | [*FlightsApi*]( |
| 85 | [*FlightsApi*]( |
| 86 | [*FlightsApi*]( |
| 87 | [*FlightsApi*]( |
| 88 | [*ProfileApi*]( |
| 89 | |
| 90 | |
| 91 | ## Documentation For Models |
| 92 | |
| 93 | - [AircraftEntity](doc/AircraftEntity.md |
| 94 | - [AircraftFlightEntity](doc/AircraftFlightEntity.md |
| 95 | - [AircraftRegistrationEntity](doc/AircraftRegistrationEntity.md |
| 96 | - [AircraftStatsEntity](doc/AircraftStatsEntity.md |
| 97 | - [AircraftWithAge](doc/AircraftWithAge.md |
| 98 | - [AirlineEntity](doc/AirlineEntity.md |
| 99 | - [AirlineInfo](doc/AirlineInfo.md |
| 100 | - [AirlineStatsEntity](doc/AirlineStatsEntity.md |
| 101 | - [AirportConditionsEntity](doc/AirportConditionsEntity.md |
| 102 | - [AirportDelayReasonEntity](doc/AirportDelayReasonEntity.md |
| 103 | - [AirportDelaysEntity](doc/AirportDelaysEntity.md |
| 104 | - [AirportEntity](doc/AirportEntity.md |
| 105 | - [AirportInfo](doc/AirportInfo.md |
| 106 | - [AirportStatsEntity](doc/AirportStatsEntity.md |
| 107 | - [AirportType](doc/AirportType.md |
| 108 | - [AirportWeatherForecastEntity](doc/AirportWeatherForecastEntity.md |
| 109 | - [AirportWeatherObservationEntity](doc/AirportWeatherObservationEntity.md |
| 110 | - [CreateFlightBookingDTO](doc/CreateFlightBookingDTO.md |
| 111 | - [FlighType](doc/FlighType.md |
| 112 | - [FlightAlertDTO](doc/FlightAlertDTO.md |
| 113 | - [FlightAwareDataEntity](doc/FlightAwareDataEntity.md |
| 114 | - [FlightBookingEntity](doc/FlightBookingEntity.md |
| 115 | - [FlightCandidateEntity](doc/FlightCandidateEntity.md |
| 116 | - [FlightControllerDeleteFlightBookingV1200Response](doc/FlightControllerDeleteFlightBookingV1200Response.md |
| 117 | - [FlightDistanceEntity](doc/FlightDistanceEntity.md |
| 118 | - [FlightDurationEntity](doc/FlightDurationEntity.md |
| 119 | - [FlightEntity](doc/FlightEntity.md |
| 120 | - [FlightPositionEntity](doc/FlightPositionEntity.md |
| 121 | - [FlightResponseEntity](doc/FlightResponseEntity.md |
| 122 | - [FlightSearchResponseEntity](doc/FlightSearchResponseEntity.md |
| 123 | - [FlightStatus](doc/FlightStatus.md |
| 124 | - [FlightSummaryAirlineEntity](doc/FlightSummaryAirlineEntity.md |
| 125 | - [FlightSummaryDestinationEntity](doc/FlightSummaryDestinationEntity.md |
| 126 | - [FlightSummaryEntity](doc/FlightSummaryEntity.md |
| 127 | - [FlightSummaryOriginEntity](doc/FlightSummaryOriginEntity.md |
| 128 | - [FlightTrackResponseEntity](doc/FlightTrackResponseEntity.md |
| 129 | - [FlightsControllerGetFlightsInBoundsV1200Response](doc/FlightsControllerGetFlightsInBoundsV1200Response.md |
| 130 | - [FlightsControllerGetFlightsInBoundsV1200ResponseBounds](doc/FlightsControllerGetFlightsInBoundsV1200ResponseBounds.md |
| 131 | - [FlightsControllerGetFlightsInBoundsV1200ResponseFlightsInner](doc/FlightsControllerGetFlightsInBoundsV1200ResponseFlightsInner.md |
| 132 | - [FlightsControllerGetFlightsInBoundsV1200ResponseFlightsInnerOrigin](doc/FlightsControllerGetFlightsInBoundsV1200ResponseFlightsInnerOrigin.md |
| 133 | - [FlightsResponseEntity](doc/FlightsResponseEntity.md |
| 134 | - [FlightsRouteEntity](doc/FlightsRouteEntity.md |
| 135 | - [GenericErrorEntity](doc/GenericErrorEntity.md |
| 136 | - [GetAirlineDTO](doc/GetAirlineDTO.md |
| 137 | - [LocationEntity](doc/LocationEntity.md |
| 138 | - [LoginDTO](doc/LoginDTO.md |
| 139 | - [LoginEntity](doc/LoginEntity.md |
| 140 | - [MostFlownAircraftEntity](doc/MostFlownAircraftEntity.md |
| 141 | - [PartialAirlineEntity](doc/PartialAirlineEntity.md |
| 142 | - [PassportEntity](doc/PassportEntity.md |
| 143 | - [ProfileStatsResponseEntity](doc/ProfileStatsResponseEntity.md |
| 144 | - [RegisterDTO](doc/RegisterDTO.md |
| 145 | - [RegisterEntity](doc/RegisterEntity.md |
| 146 | - [RouteAirportEntity](doc/RouteAirportEntity.md |
| 147 | - [RouteInfoEntity](doc/RouteInfoEntity.md |
| 148 | - [StringifiedGreatCircleDistanceEntity](doc/StringifiedGreatCircleDistanceEntity.md |
| 149 | - [TimeEntity](doc/TimeEntity.md |
| 150 | - [TopRouteEntity](doc/TopRouteEntity.md |
| 151 | - [TrackedFlightsResponseEntity](doc/TrackedFlightsResponseEntity.md |
| 152 | - [UpdateFlightBookingDTO](doc/UpdateFlightBookingDTO.md |
| 153 | - [UserEntity](doc/UserEntity.md |
| 154 | - [WeatherForecastCloudEntity](doc/WeatherForecastCloudEntity.md |
| 155 | - [WeatherForecastDecodedEntity](doc/WeatherForecastDecodedEntity.md |
| 156 | - [WeatherForecastLineEntity](doc/WeatherForecastLineEntity.md |
| 157 | - [WeatherForecastVisibilityEntity](doc/WeatherForecastVisibilityEntity.md |
| 158 | - [WeatherForecastWindsEntity](doc/WeatherForecastWindsEntity.md |
| 159 | - [WeatherForecastWindshearEntity](doc/WeatherForecastWindshearEntity.md |
| 160 | - [WeatherObservationCloudEntity](doc/WeatherObservationCloudEntity.md |
| 161 | |
| 162 | |
| 163 | ## Documentation For Authorization |
| 164 | |
| 165 | |
| 166 | Authentication schemes defined for the API: |
| 167 | ### JWT-auth |
| 168 | |
| 169 | - **Type**: HTTP Bearer Token authentication (JWT) |
| 170 | |
| 171 | |
| 172 | ## Author |
| 173 | |
| 174 | |
| 175 | |
)
project:
)
, please include the following in pubspec.yaml
)
and then run the following:
getAirlinesApi
()
;
// String | The full(or a part of) name, ident or icao. Case Insensitive.
airlinesControllerGetAirlinesV1
(search)
;
"
)
;
doc/AirlinesApi.md
)
|
[
**
airlinesControllerGetAirlinesV1
**
]
(
doc/AirlinesApi.md#airlinescontrollergetairlinesv1
)
|
**
GET
**
/v1/airlines | Get airlines
doc/AirportsApi.md
)
|
[
**
airportsControllerGetAirportsV1
**
]
(
doc/AirportsApi.md#airportscontrollergetairportsv1
)
|
**
GET
**
/v1/airports | Get all airports
doc/AppApi.md
)
|
[
**
appControllerGetHelloV1
**
]
(
doc/AppApi.md#appcontrollergethellov1
)
|
**
GET
**
/v1 |
doc/AuthenticationApi.md
)
|
[
**
authControllerGetCurrentUserV1
**
]
(
doc/AuthenticationApi.md#authcontrollergetcurrentuserv1
)
|
**
GET
**
/v1/auth/@me | Get current user
doc/AuthenticationApi.md
)
|
[
**
authControllerLoginV1
**
]
(
doc/AuthenticationApi.md#authcontrollerloginv1
)
|
**
POST
**
/v1/auth/login | Login
doc/AuthenticationApi.md
)
|
[
**
authControllerRegisterV1
**
]
(
doc/AuthenticationApi.md#authcontrollerregisterv1
)
|
**
POST
**
/v1/auth/register | Register
doc/FlightApi.md
)
|
[
**
flightControllerCreateFlightBookingV1
**
]
(
doc/FlightApi.md#flightcontrollercreateflightbookingv1
)
|
**
POST
**
/v1/flight/booking | Create a flight booking
doc/FlightApi.md
)
|
[
**
flightControllerDeleteFlightBookingV1
**
]
(
doc/FlightApi.md#flightcontrollerdeleteflightbookingv1
)
|
**
DELETE
**
/v1/flight/booking/{bookingId} | Delete a flight booking
doc/FlightApi.md
)
|
[
**
flightControllerGetFlightBookingV1
**
]
(
doc/FlightApi.md#flightcontrollergetflightbookingv1
)
|
**
GET
**
/v1/flight/booking/{bookingId} | Get a flight booking
doc/FlightApi.md
)
|
[
**
flightControllerGetFlightBookingsByFlightIdV1
**
]
(
doc/FlightApi.md#flightcontrollergetflightbookingsbyflightidv1
)
|
**
GET
**
/v1/flight/booking/flight/{flightId} | Get all bookings for a flight
doc/FlightApi.md
)
|
[
**
flightControllerGetFlightTrackV1
**
]
(
doc/FlightApi.md#flightcontrollergetflighttrackv1
)
|
**
GET
**
/v1/flight/track | Get flight track/path
doc/FlightApi.md
)
|
[
**
flightControllerGetFlightV1
**
]
(
doc/FlightApi.md#flightcontrollergetflightv1
)
|
**
GET
**
/v1/flight | Get flight details
doc/FlightApi.md
)
|
[
**
flightControllerSearchFlightsV1
**
]
(
doc/FlightApi.md#flightcontrollersearchflightsv1
)
|
**
GET
**
/v1/flight/search | Search flights
doc/FlightApi.md
)
|
[
**
flightControllerUpdateFlightBookingV1
**
]
(
doc/FlightApi.md#flightcontrollerupdateflightbookingv1
)
|
**
PUT
**
/v1/flight/booking/{bookingId} | Update a flight booking
doc/FlightAlertsApi.md
)
|
[
**
flightAlertsControllerSubscribeV1
**
]
(
doc/FlightAlertsApi.md#flightalertscontrollersubscribev1
)
|
**
POST
**
/v1/flight/{id}/alerts | Subscribe to push alerts for a flight
doc/FlightAlertsApi.md
)
|
[
**
flightAlertsControllerUnsubscribeV1
**
]
(
doc/FlightAlertsApi.md#flightalertscontrollerunsubscribev1
)
|
**
DELETE
**
/v1/flight/{id}/alerts | Unsubscribe from push alerts for a flight
doc/FlightsApi.md
)
|
[
**
flightsControllerGetAirlineV1
**
]
(
doc/FlightsApi.md#flightscontrollergetairlinev1
)
|
**
POST
**
/v1/flights/airline | Get airline
doc/FlightsApi.md
)
|
[
**
flightsControllerGetFlightsInBoundsV1
**
]
(
doc/FlightsApi.md#flightscontrollergetflightsinboundsv1
)
|
**
GET
**
/v1/flights/bounds | Get flights within geographic bounds(deprecated - will return nothing)
doc/FlightsApi.md
)
|
[
**
flightsControllerGetFlightsV1
**
]
(
doc/FlightsApi.md#flightscontrollergetflightsv1
)
|
**
GET
**
/v1/flights | Get flights between two airports
doc/FlightsApi.md
)
|
[
**
flightsControllerGetTrackedFlightsV1
**
]
(
doc/FlightsApi.md#flightscontrollergettrackedflightsv1
)
|
**
GET
**
/v1/flights/tracked | Get all tracked flights
doc/ProfileApi.md
)
|
[
**
profileControllerGetProfileStatsV1
**
]
(
doc/ProfileApi.md#profilecontrollergetprofilestatsv1
)
|
**
GET
**
/v1/profile/@me | Get profile stats
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)
)