Documentatie API
API Rentsilvania Rent a Car
Prezentare generală
Endpoint-uri publice, doar pentru citire, pentru locații, flotă, disponibilitate și cotații de preț.
Cererea acceptă date în format european (DD-MM-YYYY) prin pick_up_date și delivery_date. Răspunsurile păstrează denumirile actuale ale câmpurilor exact cum sunt implementate (de ex. pickup_date / return_date în format ISO).
URL de bază
https://www.rentsilvania.roSpecificație OpenAPI
/.well-known/openapi.jsonAgenții și motoarele de căutare pot descoperi automat acest API prin:
Link: ; rel="service-desc"GET
/api/v1/locations
Listează locațiile fixe de preluare și returnare.
Parametri query
| Nume | Tip | Obligatoriu | Descriere |
|---|---|---|---|
q |
string | Nu | Filtru opțional de tip text liber |
cURL
Copycurl -s https://www.rentsilvania.ro/api/v1/locations | jq .
Răspuns (exemplu)
Copy{
"items": [
{
"id": "clj_airport",
"name": "Aeroportul Internațional Cluj-Napoca",
"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 de mașini; dacă sunt furnizate datele, include și totalul calculat plus un indicator de disponibilitate.
Parametri query
| Nume | Tip | Obl. | Descriere |
|---|---|---|---|
car_id |
string | Nu | Filtrare după ID model |
pick_up_date |
string DD-MM-YYYY | Nu | Data preluării |
delivery_date |
string DD-MM-YYYY | Nu | Data returnă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://www.rentsilvania.ro/api/v1/cars?pick_up_date=03-11-2025&delivery_date=20-11-2025" | jq .
Element din 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://www.rentsilvania.ro/uploads/cars/big/40-seat-ibiza-s1.webp", "alt": "Exterior Seat Ibiza" }
],
"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}
Returnează detaliile complete pentru un model.
cURL
Copycurl -s https://www.rentsilvania.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://www.rentsilvania.ro/uploads/cars/big/108-vw-passat-b7-automat.webp","alt":"Exterior VW Passat"}
],
"description":"Aici vine descrierea mașinii",
"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://www.rentsilvania.ro/termeni-si-conditii"
},
"base_price":{"currency":"EUR","price_per_day":35},
"extras":[],
"links":{
"self":"https://www.rentsilvania.ro/api/v1/cars/108",
"availability":"https://www.rentsilvania.ro/api/v1/availability?car_id=108",
"quote":"https://www.rentsilvania.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 într-un anumit interval de date.
Parametri query
| 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 returnării |
cURL
Copycurl -s "https://www.rentsilvania.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": "Disponibilă pentru rezervare",
"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 o închiriere. Extraopțiunile sunt opționale și se taxează pe zi.
Body request
| 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 returnă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 | de ex. {"gps":1,"child_seat":2} |
cURL
Copycurl -s -X POST https://www.rentsilvania.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": "Bază", "detail": "37 × 17 zile / days", "amount": 629, "currency": "EUR" }
]
}
Exemple de erori
{
"error": "bad_request",
"message": "car_id, pick_up_date și delivery_date sunt obligatorii (DD-MM-YYYY)."
}
{
"error": "conflict",
"message": "Mașina nu este disponibilă pentru intervalul solicitat."
}
Contact și termeni
Suport: office@rentsilvania.ro
