Download the PHP package codebyray/carlistapi-php-sdk without Composer
On this page you can find all versions of the php package codebyray/carlistapi-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download codebyray/carlistapi-php-sdk
More information about codebyray/carlistapi-php-sdk
Files in codebyray/carlistapi-php-sdk
Package carlistapi-php-sdk
Short Description Framework-agnostic PHP SDK for the Car List API automotive, powersports, and VIN decoder endpoints.
License MIT
Informations about the package carlistapi-php-sdk
Car List API PHP SDK
Official PHP SDK for the Car List API.
The Car List API PHP SDK provides a simple, framework-independent interface for accessing the Car List API. It supports Automotive, Powersports, and VIN Decoder endpoints using authenticated requests.
The SDK works with any PHP application, including:
- Plain PHP
- Laravel
- Symfony
- Slim
- WordPress
- Custom Composer projects
Requirements
- PHP 8.2 or higher
- Composer
- A valid Car List API API token
Installation
Install the SDK using Composer:
Configuration
Create a new client using your API token.
By default the SDK uses:
| Option | Default |
|---|---|
| Base URL | https://carlistapi.com/api |
| API Version | v1 |
| Timeout | 15 seconds |
| Connect Timeout | 5 seconds |
| Retries | 2 |
To customize these values:
Quick Start
Automotive
Retrieve all supported years.
Retrieve all makes.
Retrieve models.
Retrieve complete vehicle information.
Powersports
Retrieve supported powersports types.
Retrieve available models.
VIN Decoder
Decode a VIN.
Decode using a known model year.
The SDK automatically normalizes VINs by removing spaces, hyphens, and converting letters to uppercase before sending requests.
Responses
Every successful request returns an ApiResponse object.
Retrieve a specific response header.
Error Handling
The SDK throws strongly typed exceptions.
Available exceptions include:
| Exception | Description |
|---|---|
| AuthenticationException | Invalid or missing API token |
| AuthorizationException | Insufficient permissions |
| ValidationException | Invalid request |
| NotFoundException | Resource not found |
| RateLimitException | Rate limit exceeded |
| ServerException | Server error |
| TransportException | Network or connection failure |
API Versioning
The SDK supports configurable API versions.
When a future version of the Car List API becomes available, updating the SDK configuration is all that is required.
User Agent
Requests automatically include a User-Agent identifying the SDK.
Example:
You may override the User-Agent if desired.
Endpoint Coverage
The SDK currently supports:
Automotive
- Years
- Makes
- Models
- Trims
- Engines
- Vehicle IDs
- Vehicle Details
- Logos
- Body Styles
- Fuel Types
- Drive Types
- Door Counts
Powersports
- Types
- Years
- Makes
- Models
- Sub Models
- Vehicle IDs
- Vehicle Details
- Logos
VIN Decoder
- VIN Decode
- VIN Decode with Model Year
Documentation
Complete API documentation is available at:
Support
If you discover a bug or would like to request a feature, please open an issue on GitHub.
GitHub:
https://github.com/codebyray/carlistapi-php-sdk
License
This project is licensed under the MIT License.
All versions of carlistapi-php-sdk with dependencies
guzzlehttp/guzzle Version ^7.8
psr/http-client Version ^1.0
psr/http-message Version ^1.1 || ^2.0