Autela Dealer API

Každý request musí obsahovať API kľúč v HTTP hlavičke. Kľúč nájdete v Dashboarde → Profil → API prístup.

X-Autela-Key: aak_live_xxxxxxxxxxxxxxxxxxxxxxxx

Overenie kľúča

{
  "success": true,
  "data": {
    "id": 42,
    "full_name": "AAA Auto SK s.r.o.",
    "email": "api@aaa-auto.sk",
    "subscription_plan": "dealer_pro"
  }
}

Polia označené * sú povinné pri vytváraní (POST). Pri aktualizácii (PUT) sa prepíšu len odoslané polia — ostatné zostávajú nezmenené.

<?php
class AutelaClient {
    private $key, $base = 'https://autela.sk/api/v1';
    public function __construct($apiKey) { $this->key = $apiKey; }

    public function createCar(array $data): array {
        return $this->json('POST', '/cars', $data);
    }

    public function uploadPhoto(int $carId, string $file): array {
        $ch = curl_init($this->base . "/cars/{$carId}/photos");
        curl_setopt_array($ch, [
            CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => ["X-Autela-Key: {$this->key}"],
            CURLOPT_POSTFIELDS => ['photo' => new CURLFile($file)],
        ]);
        return json_decode(curl_exec($ch), true);
    }

    public function updateCar(int $id, array $data): array {
        return $this->json('PUT', "/cars/{$id}", $data);
    }

    private function json(string $method, string $path, array $body): array {
        $ch = curl_init($this->base . $path);
        curl_setopt_array($ch, [CURLOPT_CUSTOMREQUEST => $method, CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => ["X-Autela-Key: {$this->key}", 'Content-Type: application/json'],
            CURLOPT_POSTFIELDS => json_encode($body)]);
        return json_decode(curl_exec($ch), true);
    }
}

// Použitie
$api = new AutelaClient('aak_live_xxx');
$car = $api->createCar(['brand' => 'Škoda', 'model' => 'Octavia', 'year' => 2022, 'price' => 24500]);
$api->uploadPhoto($car['data']['id'], '/var/photos/octavia_01.jpg');
$api->updateCar($car['data']['id'], ['status' => 'active']);

import requests

class AutelaClient:
    BASE = "https://autela.sk/api/v1"

    def __init__(self, api_key):
        self.headers = {"X-Autela-Key": api_key}

    def create_car(self, data):
        return requests.post(f"{self.BASE}/cars", json=data, headers=self.headers).json()

    def upload_photo(self, car_id, file_path):
        with open(file_path, "rb") as f:
            return requests.post(f"{self.BASE}/cars/{car_id}/photos",
                headers=self.headers, files={"photo": f}).json()

    def set_status(self, car_id, status):
        return requests.put(f"{self.BASE}/cars/{car_id}",
            json={"status": status}, headers=self.headers).json()

# Použitie
api = AutelaClient("aak_live_xxx")
car = api.create_car({"brand": "BMW", "model": "320d", "year": 2020, "price": 32000})
api.upload_photo(car["data"]["id"], "/photos/bmw_01.jpg")
api.set_status(car["data"]["id"], "active")

Hromadná synchronizácia — pre AAA Auto, Autopalác a podobné

/**
 * Sync skladu z DMS — spúšťajte každých 30 minút cez cron.
 */
function syncFleet(AutelaClient $api, array $dmsVehicles): void {
    // Načítanie existujúcich inzerátov (indexované podľa VIN)
    $existing = $api->getCars(['status' => 'all', 'limit' => 200]);
    $vinMap   = array_column($existing['data']['cars'], null, 'vin');

    foreach ($dmsVehicles as $v) {
        if (isset($vinMap[$v['vin']])) {
            // Existuje — aktualizuj len cenu a km
            $api->updateCar($vinMap[$v['vin']]['id'], [
                'price'   => $v['price'],
                'mileage' => $v['mileage'],
            ]);
        } else {
            // Nové auto — vytvor a nahraj fotky
            $car   = $api->createCar(mapDmsToAutela($v));
            $carId = $car['data']['id'];
            foreach ($v['photos'] as $photo) $api->uploadPhoto($carId, $photo);
            $api->updateCar($carId, ['status' => 'active']);
        }
    }

    // Označenie predaných (sú v Autele, chýbajú v DMS)
    $dmsVins = array_column($dmsVehicles, 'vin');
    foreach ($vinMap as $vin => $car) {
        if (!in_array($vin, $dmsVins))
            $api->updateCar($car['id'], ['status' => 'sold']);
    }
}

{ "success": false, "error": "Chýbajú povinné polia: brand, model" }

Získať API prístup

Pripravení na integráciu?

API kľúč nájdete v dashboarde po aktivácii plateného plánu. Pre veľké dealerské siete ponúkame individuálne podmienky a vyšší rate limit.