Reference · v1 + v2

API დოკუმენტაცია

REST · JSON (და ?format=csv) · ავთენტიფიკაცია API გასაღებით. ყველა პასუხს აქვს as_of — მონაცემის სიახლე.

ავთენტიფიკაცია

გადმოეცი გასაღები header-ით:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://dev.tarifebi.ge/v2/commerce/products?store_type=grocery

ალტერნატივა: X-Api-Key: YOUR_API_KEY. გასაღები სერვერის მხარეს ინახე — არა ბრაუზერში/მობილურში.

v1 — ცოცხალი მონაცემი

GET /v1/fuel/prices საწვავის ფასები ბრენდებით fuel_prices
GET /v1/fuel/stations სადგურების ლოკაციები (near/radius) fuel_loc
GET /v1/pharmacies აფთიაქების ლოკაციები pharmacy_loc
GET /v1/currency/rates NBG + ბანკების ყიდვა/გაყიდვა currency_rates
GET /v1/currency/exchanges გადამცვლელი პუნქტები currency_loc
GET /v1/me გასაღების plan / scopes / usage

v2 — Finance · Telecom · Locations

GET /v2/banks/list ბანკები/გადამცვლელები (?type=) banks_data
GET /v2/banks/branches ფილიალები/ბანკომატები (geo) banks_loc
GET /v2/loans/products სესხები (?bank/type/currency) banks_data
GET /v2/telecom/providers მობ. ოპერატორები telecom_tariffs
GET /v2/telecom/tariffs პაკეტები (?provider/type/roaming) telecom_tariffs
GET /v2/telecom/branches მაღაზიები (geo) telecom_loc
GET /v2/locations/search POI ძიება ?category= (near/city/q) locations_all
GET /v2/locations/categories კატეგორიები + რაოდენობა locations_all
GET /v2/locations/cities ქალაქები locations_all

v2 — Commerce (217k პროდუქტი)

GET /v2/commerce/products ძიება/სია ?store_type=&q=&on_sale=1 (FULLTEXT) commerce
GET /v2/commerce/product?id= ერთი პროდუქტი commerce
GET /v2/commerce/stores მაღაზიები + რაოდენობა commerce
GET /v2/commerce/categories კატეგორიები commerce

store_type: grocery · pharmacy · electronics · construction · kids. ყველა collection: ?limit ?offset ?format=csv.

შეცდომები

Statuserrorნიშნავს
401unauthorizedგასაღები აკლია/არასწორია
403scope_requiredგასაღები ამ dataset-ზე არ არის გამოწერილი
403subscription_requiredგამოწერა არააქტიურია
422invalid_paramარასწორი პარამეტრი
429rate_limitedლიმიტი ამოიწურა (Retry-After)

ტარიფები

თითო სერვისი ცალკე იყიდება — მაგ. საწვავი ფასები 80₾/თვე, ფასები + ლოკაცია 100₾/თვე. კომბინირებული პაკეტები (რამდენიმე სერვისი ერთად) უფრო იაფია. 1 წელი ≈ ნახევარი ფასი.

ფასების ნახვა & გასაღების მიღება →