Added #16956: API Endpoint to Retrieve Current Snipe-IT Version

[NebelKreis]

Description

This PR introduces a new API endpoint /settings/version that allows clients to retrieve the currently installed Snipe-IT version.
The goal is to support automated update workflows and reduce the need for manual version checks.
This feature is especially useful for system administrators and integration scripts that need to validate or report the current installation state before applying updates or triggering other actions.

Key Features:

• Created a new controller to handle version retrieval logic.
• Added a new API route under the settings namespace:
  GET /api/v1/settings/version
• The endpoint returns the current version in JSON format.

Fixes #16956

Attached below is an example of how the resulting output would look like:

Type of change

Please delete options that are not relevant.

• New feature (non-breaking change which adds functionality)
• This change requires a documentation update (API Explorer)

How Has This Been Tested?

The implementation has been tested through the following methods:

• Manual API call: Verified that the version is returned correctly via a GET request to /api/v1/settings/version.
• Header validation: Ensured the response uses the correct Content-Type: application/json.

Test Configuration:

• PHP version: 8.3.6
• MySQL version: 10.6.4
• Webserver version: Apache 2.4.58
• OS version: Ubuntu 24.04

Checklist:

• I have read the Contributing documentation available here: https://snipe-it.readme.io/docs/contributing-overview
• I have formatted this PR according to the project guidelines: https://snipe-it.readme.io/docs/contributing-overview#pull-request-guidelines
• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[snipe]

I think we already have a version endpoint.

snipe-it/routes/api.php

Lines 1323 to 1328 in 8a44144

	Route::get('/version', function () {
	return response()->json(
	[
	'version' => config('version.app_version'),
	], 200);
	}); // end version api routes

[uberbrady]

Thank you for making this! But @snipe is right - we do already have this - but that being said, I'm totally fine with adding the additional information that you wanted - if you can add it to the existing endpoint in-line with the version that we're already returning, we'll be happy to take it. Thank you!

[NebelKreis]

You’re right, I totally overlooked this, but I’ve made the changes now, so it should be all good.

[snipe]

I think we can pull that new controller tho?

[NebelKreis]

It depends on what we want to implement in this API endpoint later on, but I can remove it for now if necessary.

[snipe]

It depends on what we want to implement in this API endpoint later on

I'm not sure what you mean. The API endpoint already exists, you're just adding more data to it.

[snipe]

I don't think we need this? We don't allow updating most of the settings via API.