SBDocs/vehiclesplus-v3/api/gettingstarted.md

67 lines
No EOL
1.7 KiB
Markdown

---
sidebar_label: Usage
sidebar_position: 1
---
# API Usage
This guide explains how to integrate the new and improved VehiclesPlus API (v3) into your project.
## Adding VehiclesPlus to Your Project
To use the VehiclesPlus API in your plugin, follow these steps:
### Step 1: Add VehiclesPlus to Your Dependencies
Ensure VehiclesPlus is added as a dependency in your project. To always use the latest version, update your dependency
configuration as shown below:
Maven (`pom.xml`):
```xml
<!-- Append to the <repositories> section -->
<repositories>
<repository>
<id>sbdevelopment-repo</id>
<url>https://repo.sbdevelopment.tech/releases</url>
</repository>
</repositories>
<!-- Append to the <dependencies> section -->
<dependencies>
<dependency>
<groupId>tech.sbdevelopment</groupId>
<artifactId>vehiclesplus</artifactId>
<version>latest</version>
</dependency>
</dependencies>
```
Gradle (`build.gradle`):
```gradle
repositories {
maven {
url 'https://repo.sbdevelopment.tech/releases'
}
}
dependencies {
implementation 'tech.sbdevelopment:vehiclesplus:latest'
}
```
:::info
**Note**: Using `latest` ensures that your project always fetches the most recent release, but it might cause issues if
breaking changes are introduced. For more stability, consider specifying a specific version (e.g., `3.0.2`).
:::
## Examples
For usage examples, please visit
the [VehiclesPlus Examples Page](https://docs.sbdevelopment.tech/en/vehiclesplus-v3/api/examples).
## API Documentation
For additional details and advanced usage refer to the
official [VehiclesPlus Javadoc](https://sbdevelopment.tech/javadoc/vehiclesplus-v3/index.html).