Prezentare

API public (doar în citire) pentru listarea locațiilor de preluare/predare, flotei auto, verificarea disponibilității și generarea de cotații de preț.
Solicitările (request) folosesc date în format european (DD-MM-YYYY) în câmpurile pick_up_date și delivery_date.
Răspunsurile (response) păstrează exact câmpurile implementate: de ex. pickup_date / return_date în format ISO (YYYY-MM-DD).

URL Bază

https://alfarentacar.ro

Specificație OpenAPI

/.well-known/openapi.json

Descoperire automată pentru agenți AI & crawlere: adăugăm antetul HTTP
Link: ; rel="service-desc"

GET

/api/v1/locations

Listează locațiile fixe de preluare/predare.

Parametri query

Nume	Tip	Obl.	Descriere
`q`	string	Nu	Filtru text opțional (oraș, IATA, nume)

cURL

Copycurl -s https://alfarentacar.ro/api/v1/locations | jq .

Exemplu răspuns

Copy{
  "items": [
    {
      "id": "clj_airport",
      "name": "Cluj-Napoca International Airport",
      "iata_code": "CLJ",
      "address": {
        "street": "Str. Traian Vuia 149",
        "city": "Cluj-Napoca",
        "region": "Cluj",
        "postal_code": "400397",
        "country_code": "RO"
      },
      "timezone": "Europe/Bucharest"
    }
  ]
}

GET

/api/v1/cars

Listează modelele; dacă trimiți date, primești și prețul total + indiciu de disponibilitate (lead price).

Parametri

Nume	Tip	Obl.	Descriere
`car_id`	string	Nu	Filtrare după model
`pick_up_date`	string DD-MM-YYYY	Nu	Data preluării
`delivery_date`	string DD-MM-YYYY	Nu	Data predării
`category`	string	Nu	economy\|compact\|suv\|minivan\|premium
`transmission`	string	Nu	manual\|automatic
`ac`	boolean	Nu	Aer condiționat

cURL (cu date)

Copycurl -s "https://alfarentacar.ro/api/v1/cars?pick_up_date=03-11-2025&delivery_date=20-11-2025" | jq .

Item de răspuns (exemplu)

Copy{
  "id": "40",
  "make": "Seat",
  "model": "Ibiza",
  "category": "economy",
  "year": null,
  "seats": null,
  "doors": null,
  "luggage_small": null,
  "luggage_large": null,
  "transmission": null,
  "ac": true,
  "fuel_type": null,
  "features": ["usb","abs","esp"],
  "images": [
    { "url": "https://alfarentacar.ro/uploads/cars/big/40-seat-ibiza-s1.webp", "alt": "Seat Ibiza exterior" }
  ],
  "lead_price": {
    "pickup_date": "2025-11-03",
    "return_date": "2025-11-20",
    "currency": "EUR",
    "price_per_day": 26,
    "total_price": 442,
    "availability_hint": "in_stock"
  },
  "jsonld": {
    "@context": "https://schema.org",
    "@type": "Car",
    "brand": "Seat",
    "model": "Ibiza"
  }
}

GET

/api/v1/cars/{car_id}

Detalii complete pentru un model.

cURL

Copycurl -s https://alfarentacar.ro/api/v1/cars/108 | jq .

Răspuns (exemplu)

Copy{
  "id":"108",
  "make":"VW",
  "model":"Passat",
  "year":null,
  "category":"premium",
  "category_label_ro":"Family | Business",
  "seats":null,
  "doors":null,
  "luggage_small":null,
  "luggage_large":null,
  "transmission":null,
  "ac":true,
  "fuel_type":null,
  "features":["bluetooth","abs","esp","parking_sensors"],
  "images":[
    {"url":"https://alfarentacar.ro/uploads/cars/big/108-vw-passat-b7-automat.webp","alt":"VW Passat exterior"}
  ],
  "description":"Here comes the car description",
  "included":["Asigurare RCA","Asistență rutieră 24/7","Kilometraj 200 km/zi"],
  "policies":{
    "mileage_policy":"200 km/zi incluse; 0.15 EUR/km după",
    "fuel_policy":"La fel ca la preluare",
    "deposit_amount":200,
    "age_requirement":"Șofer 21+ ani, permis 2+ ani",
    "cancellation_policy":"Gratuit până la 24h înainte de preluare",
    "terms_url":"https://alfarentacar.ro/termeni-si-conditii"
  },
  "base_price":{"currency":"EUR","price_per_day":35},
  "extras":[],
  "links":{
    "self":"https://alfarentacar.ro/api/v1/cars/108",
    "availability":"https://alfarentacar.ro/api/v1/availability?car_id=108",
    "quote":"https://alfarentacar.ro/api/v1/quote"
  },
  "jsonld":{
    "@context":"https://schema.org",
    "@type":"Car",
    "brand":"Volkswagen",
    "model":"Passat"
  }
}

GET

/api/v1/availability

Verifică disponibilitatea exactă pentru un model în intervalul dorit.

Parametri (toți necesari)

Nume	Tip	Obl.	Descriere
`car_id`	string	Da	ID model
`pick_up_date`	string DD-MM-YYYY	Da	Data preluării
`delivery_date`	string DD-MM-YYYY	Da	Data predării

cURL

Copycurl -s "https://alfarentacar.ro/api/v1/availability?car_id=108&pick_up_date=03-11-2025&delivery_date=20-11-2025" | jq .

Răspuns (exemplu)

Copy{
  "car_id": "108",
  "pickup_date": "2025-11-03",
  "return_date": "2025-11-20",
  "available": true,
  "remaining_units": 2,
  "notes": "Available to reserve",
  "jsonld": {
    "@context": "https://schema.org",
    "@type": "Offer",
    "itemOffered": { "@type": "Car", "brand": "Volkswagen", "model": "Passat" },
    "availability": "https://schema.org/InStock"
  }
}

POST

/api/v1/quote

Calculează prețul final pentru perioada selectată. Toate extra-opțiunile (dacă sunt trimise) sunt tarifate pe zi.

Body (JSON)

Nume	Tip	Obl.	Descriere
`car_id`	string	Da	ID model
`pick_up_date`	string DD-MM-YYYY	Da	Data preluării
`delivery_date`	string DD-MM-YYYY	Da	Data predării
`pickup_time`	string HH:MM	Nu	Opțional
`return_time`	string HH:MM	Nu	Opțional
`currency`	string	Nu	Implicit EUR
`extras`	object (map)	Nu	Ex.: {"gps":1,"child_seat":2}

cURL

Copycurl -s -X POST https://alfarentacar.ro/api/v1/quote 
  -H "Content-Type: application/json" 
  -d '{"car_id":"88","pick_up_date":"03-11-2025","delivery_date":"20-11-2025"}' | jq .

Răspuns (exemplu)

Copy{
  "car_id": "88",
  "pickup_date": "2025-11-03",
  "return_date": "2025-11-20",
  "rental_days": 17,
  "currency": "EUR",
  "price_per_day": 37,
  "base_total": 629,
  "extras_total": 0,
  "total_price": 629,
  "breakdown": [
    { "label": "Base", "detail": "37 × 17 zile / days", "amount": 629, "currency": "EUR" }
  ]
}

Erori uzuale

Copy{
  "error": "bad_request",
  "message": "car_id, pick_up_date and delivery_date are required (DD-MM-YYYY)."
}

Copy{
  "error": "conflict",
  "message": "Car not available for the requested interval."
}

Contact & Termeni

Suport: office@alfarentacar.ro

Termeni: https://alfarentacar.ro/termeni-si-conditii