Fejlesztői dokumentáció

HartaFarmacii API

Hitelesítés

A kulcsot az X-Api-Key vagy az Authorization: Bearer fejlécben küldd. Ne tedd URL-be, nyilvános kódba vagy a felhasználóknak kiadott alkalmazásokba; tartsd a saját szervereden.

curl -H "X-Api-Key: A_KULCSOD" \
  "https://hartafarmacii.ro/api/comercial/v1/farmacii?city=Ia%C8%99i&limit=20"

Végpontok

GET	Paraméterek és válasz
`/api/comercial/v1/farmacii`	`city`, `county`, `chain`, `service` (vaccination / compounding), `limit` (1–200), `after_id`. Válasz: `data` és `meta.has_more / next_after_id`.
`/api/comercial/v1/produse`	`q` (2–100 karakter), opcionálisan `substanta`. Legfeljebb 40 találat a `results` mezőben.
`/api/comercial/v1/produse/{slug}`	A termék adatlapja a `product`, a látható ajánlatok az `offers` mezőben, `last_scraped` értékkel, árral, pénznemmel és online elérhetőséggel.
`/api/comercial/v1/gtin/{gtin}`	8, 12, 13 vagy 14 számjegyű GTIN → `slug`.
`/api/comercial/v1/produse/{slug}/istoric`	`days` (1–90, alapértelmezés 30), `limit` (1–1000), `after_id`. Megfigyelések a `data` mezőben, árral, lánccal és rögzítési dátummal; lapozás a `meta` mezőben.
`/api/comercial/v1/cont`	Csomag, kvóta, felhasználás és napi előzmények. Ez a végpont nem fogyasztja a kvótát.

Lapozás

A gyógyszertáraknál és az előzményeknél a meta.next_after_id értékével folytasd az after_id paraméterben. Állj meg, ha a has_more hamis. A kérések között tartsd meg ugyanazokat a szűrőket. A településszűrők a mellékjeles román neveket használják.

Kvóták és hibák

A kvóta az UTC szerinti naptári hónapra vonatkozik. Minden hitelesített adatkérés egy egységet fogyaszt, a hibás paraméterű vagy találat nélküli kérések is. Az elutasított hitelesítések és az irányítópult nem fogyasztják a kvótát. További korlát: 120 kérés/perc/kulcs.

X-RateLimit-Limit: a havi kvóta; X-RateLimit-Remaining: a hátralévő kérések.
X-RateLimit-Reset: a visszaállítás időpontja, Unix-időbélyegként.
400: hibás paraméterek; 401: érvénytelen vagy inaktív kulcs; 404: nem létező erőforrás.
429: korlát elérve; tartsd be a Retry-After értékét. 503: átmeneti elérhetetlenség, nem a kulcs visszavonása.

Az adatok minősége és eredete

A hiányzó érték null, nem nulla ár. Az árak tájékoztató jellegűek, és szerepel mellettük a gyűjtés dátuma. Az ajánlatot ellenőrizd a forrásnál. Egy gyógyszertár nyitvatartását és szolgáltatásait érdemes telefonon megerősíteni; az adatok nem minősülnek orvosi tanácsnak.

Forrásmegjelölés: „HartaFarmacii.ro”, hivatkozással. Az OpenStreetMap-adatoknál megmarad a forrásmegjelölés és az ODbL kötelezettségei. Az előfizetés nem ruház át kizárólagos jogokat harmadik felek forrásaira vagy képeire.

Az API-előfizetés feltételei

Starter: havi 19 € és 10 000 kérés; Pro: havi 49 € és 100 000 kérés; Business: havi 149 € és 1 000 000 kérés. Minden csomag 3 napos próbaidőt tartalmaz. A kártyát és a fizetési feltételeket a Stripe-ban erősíted meg.

Az előfizetés lemondásig havonta megújul. A portálon történő lemondás az aktuális időszak végén leállítja a megújítást; a próbaidő alatt az első terhelés előtt lemondhatod. A csomagváltásokat és az esetleges fizetési különbözeteket a Stripe a megerősítés előtt megmutatja.

A kvótán felüli kérésekért nincs automatikus számlázás. A szolgáltatás hozzáférést ad a rendelkezésre álló adatokhoz, és nem garantál készletet, teljes lefedettséget, megszakítás nélküli működést vagy rögzített válaszidőt. Az oldal felhasználási feltételei és adatvédelmi szabályzata is érvényesek; a fogyasztók törvényes jogai továbbra is megilletik őket.

A fizetést, a számlákat és a nyugtákat a Stripe a Linken keresztül kezeli, amely hivatalos eladóként (merchant of record) jár el: kiszámítja és beszedi az országodban érvényes adókat (áfa stb.), a bankszámlakivonaton pedig LINK.COM* szerepel. A fenti árak nem tartalmazzák az áfát. Az előfizetést az irányítópultról vagy a Link-fiókodból kezeled. Az API-kulcshoz és az előfizetéshez szükséges értesítésekhez a fizetéskor megadott e-mail-címet használjuk. A kártyaadatokat nem tároljuk. Támogatás és előfizetési kérések: contact@hartafarmacii.ro.