API public și date deschise
Saloanele, specialiștii și anunțurile de pe Salon Aproape se pot citi și de programe: o interfață JSON fără cheie, cu limită pe IP, plus fișierele pe care le citesc asistenții AI. Fără date de contact: utilizatorul e trimis pe pagina furnizorului.
Ce poți citi
Toate adresele răspund cu JSON, la cereri GET, fără cheie. Datele sunt aceleași ca pe paginile publice ale site-ului.
| Adresă | Ce întoarce | Parametri |
|---|---|---|
/api/v1/cauta | Căutare în limbaj natural („frizerie deschisă acum oradea”) sau cu filtre | q, categorie, judet, oras, tip=salon|pfa, verificat=1, azi=1, deschis=1, page, per_page (≤ 50) |
/api/v1/listings | Anunțurile active (servicii), cele mai noi întâi | category, county, page, per_page (≤ 100) |
/api/v1/listings/{slug} | Un anunț | – |
/api/v1/salons | Saloane (cel mult 200 pe cerere), cu programul și „deschis acum” | county |
/api/v1/salons/{slug} | Un salon | – |
/api/v1/pfa | Specialiști independenți (cel mult 200) | – |
/api/v1/pfa/{slug} | Un specialist | – |
/api/v1/joburi | Anunțuri de angajare și posturi de închiriat, active | tip=angajare|post, judet, oras |
/api/v1/categories | Categoriile și subcategoriile | – |
/api/v1/counties | Județele | – |
/api/v1/cities/{countySlug} | Orașele unui județ | – |
/api/v1/openapi.json | Descrierea OpenAPI 3 a acestui API | – |
/api/v1/health | Starea serviciului | – |
Fiecare anunț vine cu prețul pus de furnizor (sau „La cerere”), oferta activă, eticheta „Liber azi / mâine”, iar fiecare furnizor cu programul și cu „deschis acum” calculat pe ora României în momentul cererii.
Exemple
Căutare în limbaj natural, ca în caseta de pe site:
curl "https://salonaproape.ro/api/v1/cauta?q=frizerie+deschisa+acum+oradea"Răspunsul spune cum a fost înțeleasă căutarea și dă anunțurile:
{
"interpretare": { "categorie": { "slug": "frizerie", "nume": "Frizerie & Bărbierit" }, "oras": "oradea",
"filtre": { "deschis": true, "azi": false, "verificat": false, "tip": null } },
"data": [ { "title": "Tuns bărbați", "price_text": "60 lei", "url": "https://salonaproape.ro/anunturi/…",
"provider": { "name": "…", "url": "https://salonaproape.ro/salon/…", "deschis_acum": true,
"stare": "Deschis acum · închide la 20:00", "rating": 4.8, "review_count": 12 } } ],
"pagination": { "page": 1, "per_page": 20, "total": 7, "total_pages": 1 }
}Saloanele dintr-un județ, cu program:
curl "https://salonaproape.ro/api/v1/salons?county=cluj"Descrierea completă, pentru unelte și agenți: /api/v1/openapi.json (OpenAPI 3).
Reguli de folosire
- Limită: 60 de cereri pe minut pe adresă IP; peste, răspunsul e 429. Răspunsurile stau în cache 60 de secunde, deci nu are rost să ceri mai des.
- Atribuire: când arăți datele, scrie „Sursa: Salon Aproape” cu legătură spre pagina furnizorului sau a anunțului (câmpul
url). - Fără date de contact: telefonul, WhatsApp-ul și emailul nu sunt în API. Trimite omul pe
url; acolo furnizorul își arată contactul așa cum a ales. - Fără copiere în masă: interfața e pentru răspunsuri la întrebări și integrări, nu pentru a reconstrui directorul în altă parte. Datele sunt publice, dar baza de date ca întreg e a Salon Aproape.
- Prețurile cu
price_type = "poa"sunt „la cerere”; cele cu sumă sunt puse de furnizor și pot fi oferte cu termen (câmpuloferta). Nu le prezenta ca garantate. - Schimbări: versiunea curentă e 1.1; schimbările care rup compatibilitatea se anunță pe Ce construim cu cel puțin 30 de zile înainte.
Pentru asistenți AI
Asistenții și agenții pot folosi direct:
/llms.txt: ce este site-ul, paginile-cheie, categoriile, cum se citează./sitemap.xml: toate paginile (saloane, specialiști, anunțuri, pagini „serviciu + oraș”, prețuri, joburi), cu data ultimei schimbări.- Date structurate schema.org pe fiecare pagină:
BeautySalon,OfferCatalog,OpeningHoursSpecification,Review,JobPosting,FAQPage. /api/v1/openapi.jsonși/api/v1/cauta?q=…pentru întrebări de tipul „frizerie deschisă acum în Oradea” sau „manichiură în Florești”.
Răspunsurile bune spun ce e pe site (saloane, prețuri orientative sau puse de furnizor, locuri libere azi) și trimit utilizatorul pe pagina furnizorului pentru contact. Salon Aproape nu face programări și nu percepe comision.
Întrebări frecvente
Răspunsuri verificate pe ce întreabă cele mai des clientele înainte de programare.