Documentație pentru dezvoltatori

API HartaFarmacii

Autentificare

Trimite cheia în X-Api-Key sau Authorization: Bearer. Nu o pune în URL, cod public ori aplicații distribuite utilizatorilor; păstreaz-o pe serverul tău.

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

Endpointuri

GET	Parametri și răspuns
`/api/comercial/v1/farmacii`	`city`, `county`, `chain`, `service` (vaccination / compounding), `limit` (1–200), `after_id`. Răspuns: `data` și `meta.has_more / next_after_id`.
`/api/comercial/v1/produse`	`q` (2–100 caractere), opțional `substanta`. Maximum 40 de rezultate în `results`.
`/api/comercial/v1/produse/{slug}`	Fișa produsului în `product` și ofertele vizibile în `offers`, cu `last_scraped`, preț, monedă și disponibilitate online.
`/api/comercial/v1/gtin/{gtin}`	GTIN de 8, 12, 13 sau 14 cifre → `slug`.
`/api/comercial/v1/produse/{slug}/istoric`	`days` (1–90, implicit 30), `limit` (1–1.000), `after_id`. Observații în `data`, cu preț, lanț și data înregistrării; paginare în `meta`.
`/api/comercial/v1/cont`	Plan, cotă, consum și istoric pe zile. Acest endpoint nu consumă cota.

Paginare

Pentru farmacii și istoric, continuă cu valoarea meta.next_after_id în parametrul after_id. Oprește-te când has_more este fals. Păstrează aceleași filtre între cereri. Filtrele de localitate folosesc numele cu diacritice.

Cote și erori

Cota este pe luna calendaristică UTC. Cererile autentificate către date consumă o unitate, inclusiv cele cu parametri greșiți sau fără rezultat. Autentificările respinse și dashboardul nu consumă cota. Limită suplimentară: 120 cereri/minut/cheie.

X-RateLimit-Limit: cota lunară; X-RateLimit-Remaining: cereri rămase.
X-RateLimit-Reset: momentul resetării, timestamp Unix.
400: parametri greșiți; 401: cheie invalidă sau inactivă; 404: resursă inexistentă.
429: limită atinsă; respectă Retry-After. 503: indisponibilitate temporară, nu revocarea cheii.

Calitatea și proveniența datelor

O valoare absentă este null, nu un preț zero. Prețurile sunt orientative și au data colectării. Verifică oferta la sursă. Programul și serviciile unei farmacii pot necesita confirmare telefonică; datele nu reprezintă sfat medical.

Atribuire: „HartaFarmacii.ro”, cu link. Pentru datele OpenStreetMap se păstrează atribuirea și obligațiile ODbL. Abonamentul nu transferă drepturi exclusive asupra surselor sau imaginilor terților.

Condițiile abonamentului API

Starter: 19 €/lună și 10.000 cereri; Pro: 49 €/lună și 100.000 cereri; Business: 149 €/lună și 1.000.000 cereri. Toate planurile includ 3 zile de probă. Cardul și condițiile de plată se confirmă în Stripe.

Abonamentul se reînnoiește lunar până la anulare. Anularea din portal oprește reînnoirea la finalul perioadei curente; în perioada de probă poți anula înainte de prima încasare. Schimbările de plan și eventualele diferențe de plată sunt prezentate de Stripe înainte de confirmare.

Nu există facturare automată pentru cererile peste cotă. Serviciul oferă acces la datele disponibile și nu garantează stocuri, acoperire exhaustivă, continuitate fără întreruperi sau un timp de răspuns fix. Se aplică și termenii site-ului și politica de confidențialitate; drepturile legale ale consumatorilor rămân aplicabile.

Facturarea este procesată de Stripe. Pentru cheia API și comunicările necesare abonamentului folosim emailul furnizat la plată. Nu stocăm datele cardului. Suport și solicitări privind abonamentul: contact@hartafarmacii.ro.