🤖 AI Booking API

Automatizované objednávky dodávek přes AI agenty (ChatGPT, Claude, Gemini)

🚀 Rychlý start

API umožňuje AI agentům automaticky rezervovat dodávky. Podporujeme ChatGPT, Claude, Gemini a další AI asistenty.

✓ REST API ✓ JSON formát ✓ API key autentizace

📍 Základní informace

Parametr Hodnota
Base URL https://dodavkyznojmo.cz/api/ai/
Formát JSON
Autentizace API Key (pouze pro create-booking a find-client)
CORS Povoleno (*)

🔑 Autentizace

Pro vytváření rezervací potřebujete API key. Kontaktujte info@dodavkyznojmo.cz pro získání přístupu.

Způsoby autentizace:

// 1. Authorization header (doporučeno)
Authorization: Bearer ai_test_key_2025

// 2. Custom header
X-API-Key: ai_test_key_2025

// 3. URL parametr (pouze pro testování)
?api_key=ai_test_key_2025

📡 API Endpointy

GET /api/ai/info.php

Základní informace o půjčovně

Veřejné (bez API key)
GET https://dodavkyznojmo.cz/api/ai/info.php
{
  "success": true,
  "service": {
    "name": "Dodávky Znojmo - PPL AUTOCENTRUM",
    "api_version": "1.0.0",
    "ai_booking_enabled": true
  },
  "contact": { ... },
  "pricing": { ... }
}

GET /api/ai/vehicles.php

Seznam všech dostupných vozidel

Veřejné (bez API key)
GET https://dodavkyznojmo.cz/api/ai/vehicles.php
{
  "success": true,
  "count": 3,
  "vehicles": [
    {
      "id": 21,
      "name": "Mercedes Sprinter",
      "price_per_day": { "amount": 1590, "currency": "CZK" },
      "image_url": "https://dodavkyznojmo.cz/obrazky/veh-21/1-hlavni.jpg"
    }
  ]
}

POST /api/ai/check-availability.php

Kontrola dostupnosti vozidel v daném období

Veřejné (bez API key)
POST https://dodavkyznojmo.cz/api/ai/check-availability.php

Parametry:

Parametr Typ Popis
from string Datum začátku (YYYY-MM-DD nebo YYYY-MM-DD HH:MM)
to string Datum konce (YYYY-MM-DD nebo YYYY-MM-DD HH:MM)
vehicle_id int (optional) ID konkrétního vozidla
{
  "from": "2025-02-15",
  "to": "2025-02-20"
}
{
  "success": true,
  "period": { "from": "2025-02-15 08:00:00", "to": "2025-02-20 23:59:59", "days": 6 },
  "available_vehicles": 3,
  "vehicles": [
    {
      "id": 21,
      "name": "Mercedes Sprinter",
      "available": true,
      "estimated_price": {
        "days": 6,
        "total_with_vat": 11534.40,
        "currency": "CZK"
      }
    }
  ]
}

POST /api/ai/find-client.php

Vyhledání klienta v databázi

⚠️ Vyžaduje API key
POST https://dodavkyznojmo.cz/api/ai/find-client.php

Parametry:

Parametr Typ Popis
email string (optional) Email klienta
phone string (optional) Telefon klienta
{
  "email": "jan.novak@example.com"
}

POST /api/ai/create-booking.php

🎯 Hlavní endpoint pro vytvoření rezervace

⚠️ Vyžaduje API key
POST https://dodavkyznojmo.cz/api/ai/create-booking.php

Parametry:

Parametr Typ Popis
vehicle_id int ID vozidla (povinné)
from string Datum začátku (povinné)
to string Datum konce (povinné)
client object Údaje o klientovi (povinné)
ai_agent string Název AI agenta (např. "ChatGPT")

Příklad:

{
  "vehicle_id": 21,
  "from": "2025-02-15",
  "to": "2025-02-20",
  "client": {
    "first_name": "Jan",
    "last_name": "Novák",
    "email": "jan.novak@example.com",
    "phone": "+420 602 123 456",
    "birth_date": "1990-05-15",
    "id_card": "123456789",
    "drivers_license": "987654321",
    "address": {
      "street": "Hlavní 123",
      "city": "Znojmo",
      "postal_code": "669 02"
    }
  },
  "ai_agent": "ChatGPT"
}
{
  "success": true,
  "booking_id": 175,
  "client_id": 42,
  "status": "nova",
  "email_sent": true,
  "contract_url": "https://dodavkyznojmo.cz/smlouva-najem.php?id=175",
  "message": "Rezervace úspěšně vytvořena! Email s potvrzením odeslán klientovi."
}

📝 Příklad kompletního procesu

Krok za krokem:

  1. Získat základní info: GET /api/ai/info.php
  2. Zeptat se uživatele na datum
  3. Zkontrolovat dostupnost: POST /api/ai/check-availability.php
  4. Nabídnout dostupná vozidla uživateli
  5. Zeptat se na kontaktní údaje
  6. Vytvořit rezervaci: POST /api/ai/create-booking.php
  7. Klient obdrží email s potvrzením a smlouvou

🔧 Poznámky pro AI agenty

📧 Kontakt

Pro získání API klíče kontaktujte:

📧 Email: info@dodavkyznojmo.cz

📞 Telefon: +420 602 748 560

← Zpět na dodavkyznojmo.cz