🤖 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:
- Získat základní info:
GET /api/ai/info.php
- Zeptat se uživatele na datum
- Zkontrolovat dostupnost:
POST /api/ai/check-availability.php
- Nabídnout dostupná vozidla uživateli
- Zeptat se na kontaktní údaje
- Vytvořit rezervaci:
POST /api/ai/create-booking.php
- Klient obdrží email s potvrzením a smlouvou
🔧 Poznámky pro AI agenty
- ✅ Všechny rezervace mají automaticky poznámku "Objednáno - AI"
- ✅ Po vytvoření rezervace je automaticky odeslán email klientovi
- ✅ Minimální doba pronájmu: 1 den
- ✅ Ceny jsou uvedeny včetně 21% DPH
- ✅ Vratná kauce: 5000 Kč
- ✅ Řidičský průkaz skupiny B je nutný
📧 Kontakt