1.3165.1 • Published 4 months ago

@volant-autonomy/via-sdk v1.3165.1

Weekly downloads
-
License
MIT
Repository
-
Last release
4 months ago

Volant Via SDK

@volant-autonomy/via-sdk is an auto-generated type-safe wrapper for the Via API with automatic authentication handling. Usable in TypeScript or JavaScript.

Note: To use this SDK you need access to the Via API. Please contact us at via@volantautonomy.com to obtain access.

Installation

Run npm install --save @volant-autonomy/via-sdk to add the SDK as a dependency.

Basic usage

import { createSDK } from '@volant-autonomy/via-sdk'

const SDK = createSDK({
  username: "username",
  password: "password"
})

const {error, data} = await SDK.direct.getAllAircraft()

Further information

SDK Layout

The SDK is split into three parts:

  • Direct: Gives you direct access to every single API endpoint, returning the raw data
  • Composite: Convenient wrappers around multi-endpoint operations
  • Schemas: Every schema from the api as a TypeScript type

Auth

If you provide a username and password, the SDK will automatically check for expiry and refresh the authentication token whenever you make a request.

Request data format

In the API, data may be passed in through the body, the URL, the query, the header, etc. The SDK simplifies this, and just always takes data in as function arguments.

For example, GET /flightplans/ takes in a filter from a query parameter. The SDK does this through function arguments, ie: SDK.direct.getAllFlightplans(['Accepted']) would filter for only accepted flightplans.

Another example, GET /flightplans/{flightplan_id} takes in a flightplan ID through the path. The SDK does this through function arguments, ie: SDK.direct.getFlightplan('aaaaa-bbbbb-ccccc')

Feature list

As well as offering methods for all endpoints within the API, you have access to a variety of features in this API Wrapper that help make some common workflows more convenient. These features are as follows:

FeatureRemarkMethod
Upsert FlightplanCreate a flightplan no ID is supplied. Update existing flightplan if ID is suppliedupsertFlightplan()
Fetch Draft FlightplansWill fetch a list flightplans that you own that are in Draft stategetAllDraftFlightplans()
Fetch Closed FlightplansWill fetch a list flightplans that you own that are in Closed stategetAllClosedFlightplans()
Fetch Pending FlightplansWill fetch a list flightplans that you own that are in Pending stategetAllPendingFlightplans()
Fetch Accepted FlightplansWill fetch a list flightplans that you own that are in Accepted stategetAllAcceptedFlightplans()
Flightplan approvalWill attempt to update the state of a Flightplan to AcceptedattemptAcceptFlightplan()
Temporal DeconflictionWill attempt to temporally deconflict your flightplan and update the departure timeattemptTemporalDeconfliction()
PathingWill perform a pathing request and return the pathing resultdoPathingTask()

Response data format

Direct functions return an object with a data field and an error field. Only exactly one of these is defined, the other is undefined.

The data returned is also not identical to the API, as any "links" are skipped over, to make the data easier to use.

For example, if the API would've returned:

{
  link:"/url",
  data: [
    {data: 1, link: "/url"}, 
    {data: 2, link: "/url"}
  ]
}

The SDK will instead just return [1,2].

Keeping this in mind, the API documentation is a great place to look for more information

1.3165.1

4 months ago

1.3162.1

4 months ago

1.3153.1

4 months ago

1.3109.1

4 months ago

1.3127.1

4 months ago

1.3100.1

4 months ago

1.3070.1

4 months ago

1.3071.1

4 months ago

1.3074.1

4 months ago

1.3094.1

4 months ago

1.3107.1

4 months ago

1.3033.1

5 months ago

1.3025.1

5 months ago

1.3003.1

5 months ago

1.2956.1

5 months ago

1.2935.1

5 months ago

1.2984.1

5 months ago

1.2953.1

5 months ago

1.2976.1

5 months ago

1.2895.1

6 months ago

1.2908.1

6 months ago

1.2910.1

6 months ago

1.2875.1

6 months ago

1.2838.1

6 months ago

1.2874.1

6 months ago

1.2861.1

6 months ago

1.2826.1

6 months ago

1.2815.1

6 months ago

1.2817.1

6 months ago

1.2821.1

6 months ago

1.2810.2

6 months ago

1.2801.1

7 months ago

1.2773.1

7 months ago

1.0.2

10 months ago

1.0.1

10 months ago

1.0.0

10 months ago