PHP code example of consultasdeveiculos / sdk

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

consultasdeveiculos / sdk example snippets

onsultasdeveiculos\SDK\Core\SDK as ConsultadeveiculosSDK;

// Modo Produção
$client = new ConsultadeveiculosSDK([
    'auth_token' => 'SEU_TOKEN'
]);

// Consultar veículo
$resultado = $client->veiculos_agregados(['placa' => 'ABC1234']);
echo $resultado['data']['modelo']; // Modelo do veículo

// Modo Sandbox - sem token, sem requisições reais
$client = new ConsultadeveiculosSDK(['sandbox' => true]);

// Retorna respostas simuladas do Postman
$resultado = $client->veiculos_agregados(['placa' => 'ABC1234']);
// $resultado['sandbox'] === true

$client->help();              // Exibe ajuda completa
$client->help('veiculos');    // Filtra endpoints por termo
$client->endpoints();         // Lista todos os endpoints
$client->info();              // Informações do SDK

// Métodos sem output no console
$client->getInfo();           // Retorna array com informações
$client->listEndpoints();     // Retorna array com todos os endpoints
$client->listSlugs();         // Retorna array com todos os slugs
$client->searchEndpoints('x');// Busca endpoints por padrão

use Consultasdeveiculos\SDK\Errors\AuthenticationError;
use Consultasdeveiculos\SDK\Errors\ValidationError;
use Consultasdeveiculos\SDK\Errors\RateLimitError;
use Consultasdeveiculos\SDK\Errors\EndpointNotFoundError;
use Consultasdeveiculos\SDK\Errors\SDKError;

try {
    $result = $client->veiculos_agregados(['placa' => 'ABC1234']);
} catch (AuthenticationError $e) {
    // Token inválido ou expirado
} catch (ValidationError $e) {
    // Parâmetros inválidos
} catch (RateLimitError $e) {
    // Limite de requisições - espere $e->retryAfter segundos
} catch (EndpointNotFoundError $e) {
    // Slug não existe
} catch (SDKError $e) {
    // Erro genérico da SDK
    echo $e->code;      // Código do erro
    echo $e->details;   // Detalhes adicionais
    echo $e->timestamp; // Timestamp ISO
}

src/
├── Core/
│   ├── SDK.php              ← Entry point, lógica central com __call
│   ├── ConfigManager.php    ← Gerenciamento de configuração e cache
│   ├── EndpointBuilder.php  ← Construção da API dinâmica
│   ├── EndpointRegistry.php ← Registro de endpoints
│   └── PostmanLoader.php    ← Carregamento da coleção Postman
├── Transport/
│   ├── Transport.php        ← Interface base
│   ├── HttpTransport.php    ← HTTP real (Guzzle)
│   └── SandboxTransport.php ← Respostas simuladas
├── Parser/
│   ├── PostmanParser.php    ← Parser principal
│   ├── FolderParser.php     ← Parser de pastas/namespaces
│   └── RequestParser.php    ← Parser de requisições
├── Errors/
│   ├── SDKError.php
│   ├── AuthenticationError.php
│   ├── ValidationError.php
│   ├── RateLimitError.php
│   ├── EndpointNotFoundError.php
│   └── SpecificationError.php
├── Cli/
│   ├── EndpointsCommand.php
│   ├── UpdateCommand.php
│   ├── VersionCommand.php
│   ├── DoctorCommand.php
│   └── ClearCacheCommand.php
└── Cache/
    └── (placeholder)