# @exavault/exavault-api

> ExaVault API Javascript library

Latest version **2.2.5** (published 2021-07-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install @exavault/exavault-api
pnpm add @exavault/exavault-api
yarn add @exavault/exavault-api
bun add @exavault/exavault-api
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.2.5 |
| Published | 2021-07-22 |
| First published | 2020-10-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 1.8 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | support@exavault.com |
| Maintainers | ykravchuk-exavault, amy-exavault, exavault-support |

## Links

- npm: https://www.npmjs.com/package/@exavault/exavault-api
- Repository: https://github.com/ExaVault/evapi-javascript
- Homepage: https://github.com/ExaVault/evapi-javascript#readme
- Issues: https://github.com/ExaVault/evapi-javascript/issues
- npm.io page: https://npm.io/package/@exavault/exavault-api

## Dependencies (1)

- [superagent](https://npm.io/package/superagent.md) ^6.0.0

## Recent versions

- 2.2.5 (latest) — 2021-07-22
- 2.2.4 — 2021-04-12
- 2.2.3 — 2020-12-03
- 2.2.2 — 2020-11-24
- 2.2.1 — 2020-11-05
- 2.2.0 — 2020-10-30
- 2.1.0 — 2020-10-29
- 2.0.4 — 2020-10-15
- 2.0.3 — 2020-10-13
- 2.0.2 — 2020-10-13
- 2.0.1 — 2020-10-12
- 2.0.0 — 2020-10-12

## README

# ExaVault JavaScript API Library - v2 API

## Introduction
Welcome to ExaVault's JavaScript code library for our v2 API. Our v2 API will allow you to interact with all aspects of the service the same way our web portal would. The library is generated from our API's [public swagger YAML file](https://www.exavault.com/api/docs/evapi_2.0_public.yaml)

## Requirements

To use this library [Node.js](https://nodejs.org/) should be installed in the system. We recommend using version 10 or higher.

You will also need an [ExaVault](https://www.exavault.com) account, as well as an API key and access token.

## Installation

There are three installation options:

#### 1. Install from npm registry (recommended)
#

```shell
npm install @exavault/exavault-api --save
```

#### 2. Install from Github (use this if you cannot install from npm registry)
#

```shell
npm install ExaVault/evapi-javascript --save
```

#### 3. Download zip archive with code
#

- Go to ExaVault JavaScript API library [homepage](https://github.com/ExaVault/evapi-javascript).

- Click on *Code -> Download* and you will get an archive with code, which you need to unarchive to your destination folder.

- Then go to the folder with library and run the following command to install all dependencies:

```
npm install
```

Now you're ready to include the library to your code and start making calls to the ExaVault API.

## Sample Code

For a gentle introduction to using JavaScript code with ExaVault's API, check out [our code samples](https://github.com/ExaVault/evapi-javascript-samples). Follow the instructions in that repository's README to run the sample scripts, which will demonstrate how to use JavaScript Library to interact with your ExaVault account.

## Writing Your Own Code

After you have completed the installation steps above, you're all set to write your own code.
Here is an example of how to get your account information from the API.

```javascript
const ExaVaultApi = require('@exavault/exavault-api');

const evApiKey = "evApiKey_example";
const evAccessToken = "evAccessToken_example";
const evAccountUrl = "https://your_account_name.exavault.com/api/v2";

// Create api object instance with account url configuration
// Note that we must provide an accountname to the API
const apiClient =   new ExaVaultApi.ApiClient();
apiClient.basePath = evAccountUrl;

const api = new ExaVaultApi.AccountApi(apiClient);

// Process response data from the API
const callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};

// Make a call to ExaVault API to get account data
api.getAccount(evApiKey, evAccessToken, {}, function(error, data) {
    // Use `data` argument to access response data
    // Use `error` argument to access any errors
});
```

If you'd like to see this done in sample code, please take a look at [our code samples](https://github.com/ExaVault/evapi-javascript-samples)

## Author

support@exavault.com

---
_Source: https://npm.io/package/@exavault/exavault-api · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._