nobetci_eczane_api 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2a8facb665f17f0ead86695db01efb176796f9537ba5b97f9b79f1d053bb7e1d
+  data.tar.gz: 1cc991ef303279f538cd1ad1a640a561bfa43b0eff128705c6d0d838ea3a4300
+SHA512:
+  metadata.gz: 90092b266b4d223db219cbf1a5f7bab60a2ce919cdfebc969cbfd3f6c8afd93544cb9a7a2431db53ca8bd13dde21f2a6a47f8084e96dfd692a6ac7cbdf40a518
+  data.tar.gz: c988498b9a0815059f1004c4a863013c31db5e246cd1251e93ca2e4bd5f7d28efd20bcac951c9017103c02a11e6587aed2d5b5dfcabba24916623d3fe697dfda

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mehmet Erdoğan (Eczaneler.ORG)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,145 @@
+# NobetciEczaneApi Ruby SDK
+
+Official Ruby Gem for **[Eczaneler.ORG](https://eczaneler.org)** v2 REST API.
+
+Provides real-time duty pharmacies (nöbetçi eczaneler), coordinate-based nearby search, comprehensive city/district lists, and account status management for 81 provinces of Turkey and Northern Cyprus.
+
+---
+
+## 🚀 Kurulum (Installation)
+
+Gemfile dosyanıza ekleyin:
+
+```ruby
+gem 'nobetci_eczane_api'
+```
+
+Ardından bundle komutunu çalıştırın:
+
+```bash
+bundle install
+```
+
+Veya doğrudan RubyGems üzerinden kurun:
+
+```bash
+gem install nobetci_eczane_api
+```
+
+---
+
+## ⚡ Hızlı Başlangıç (Quickstart)
+
+```ruby
+require 'nobetci_eczane_api'
+
+# İstemciyi başlatın
+client = NobetciEczaneApi::Client.new('SIZIN_API_ANAHTARINIZ')
+
+# Türkiye geneli anlık nöbetçi eczaneleri listeleme
+response = client.get_sentry_pharmacies(page: 1, limit: 10)
+
+puts "Toplam Kayıt: #{response.pagination.total}"
+response.data.each do |pharmacy|
+  puts "#{pharmacy.name} (#{pharmacy.city}/#{pharmacy.district}) - Tel: #{pharmacy.phone}"
+  puts "Adres: #{pharmacy.address}"
+end
+```
+
+---
+
+## 📖 Kullanım Örnekleri (Examples)
+
+### 1. Şehir ve İlçe Bazlı Nöbetçi Eczaneler
+
+```ruby
+# İstanbul (34) nöbetçi eczaneleri
+istanbul_res = client.get_sentry_by_city(34, limit: 50)
+istanbul_res.data.each do |p|
+  puts "#{p.name} - #{p.district} - Tel: #{p.phone}"
+end
+
+# İstanbul Kadıköy (34, 440) nöbetçi eczaneleri
+kadikoy_res = client.get_sentry_by_district(34, 440)
+kadikoy_res.data.each do |p|
+  puts "#{p.name} - #{p.address}"
+end
+```
+
+### 2. GPS Koordinatlarına Göre En Yakın Eczaneler
+
+```ruby
+# Kadıköy Moda koordinatlarına en yakın nöbetçi eczaneler
+nearby = client.get_nearby_pharmacies(
+  latitude: 40.9876,
+  longitude: 29.0234,
+  is_sentry: true,
+  limit: 5
+)
+
+nearby.data.each do |p|
+  puts "#{p.name} (#{p.distance_km} km mesafede) - Tel: #{p.phone}"
+end
+```
+
+### 3. İl ve İlçe Listeleri
+
+```ruby
+# Tüm iller
+cities = client.get_cities
+cities.data.each do |city|
+  puts "[#{city.plate_code}] #{city.name} (ID: #{city.id})"
+end
+
+# İstanbul ilçeleri
+districts = client.get_districts(34)
+districts.data.each do |district|
+  puts "#{district.name} (ID: #{district.id})"
+end
+```
+
+### 4. Hesap ve Kota Durumu
+
+```ruby
+account = client.get_account_info
+info = account.data
+
+puts "Paket: #{info.active_package}"
+puts "Kalan Gün: #{info.days_left}"
+puts "Hız Limiti: #{info.rate_limit}"
+puts "İzinli IP'ler: #{info.allowed_ips.join(', ')}"
+```
+
+### 5. Hata Yönetimi (Error Handling)
+
+```ruby
+begin
+  client.get_sentry_by_city(34)
+rescue NobetciEczaneApi::AuthenticationError => e
+  puts "Yetkilendirme Hatası: #{e.message}"
+rescue NobetciEczaneApi::RateLimitError => e
+  puts "Hız Limiti Aşıldı (429): #{e.message}"
+rescue NobetciEczaneApi::ValidationError => e
+  puts "Doğrulama Hatası: #{e.message}"
+rescue NobetciEczaneApi::NetworkError => e
+  puts "Ağ Hatası: #{e.message}"
+rescue NobetciEczaneApi::Error => e
+  puts "Genel API Hatası: #{e.message} (HTTP #{e.status_code})"
+end
+```
+
+---
+
+## 🛠️ Modeller ve Özellikler
+
+- **`Pharmacy`**: `id`, `name`, `slug`, `city`, `city_id`, `district`, `district_id`, `address`, `address_description`, `phone`, `phone2`, `duty_start`, `duty_end`, `latitude`, `longitude`, `distance_km`, `is_sentry`, `source`
+- **`City`**: `id`, `name`, `slug`, `plate_code`
+- **`District`**: `id`, `name`, `slug`, `city_id`
+- **`AccountInfo`**: `status`, `email`, `active_package`, `days_left`, `end_date`, `allowed_ips`, `rate_limit`
+- **`Pagination`**: `total`, `per_page`, `current_page`, `total_pages`, `has_more`
+
+---
+
+## 📄 Lisans
+
+MIT Lisansı ile korunmaktadır. Detaylar için [LICENSE](LICENSE) dosyasına bakabilirsiniz.

data/lib/nobetci_eczane_api/client.rb

@@ -0,0 +1,270 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+require "openssl"
+
+module NobetciEczaneApi
+  # Eczaneler.ORG v2 REST API resmi Ruby istemcisi.
+  class Client
+    DEFAULT_BASE_URL = "https://api.eczaneler.org/v2"
+    DEFAULT_TIMEOUT = 10
+    DEFAULT_OPEN_TIMEOUT = 5
+    USER_AGENT = "NobetciEczane-Ruby-SDK/#{NobetciEczaneApi::VERSION}"
+
+    attr_reader :api_key, :base_url, :timeout, :open_timeout
+
+    # Yeni bir API istemcisi örneği oluşturur.
+    #
+    # @param api_key [String] Eczaneler.ORG API Anahtarı
+    # @param base_url [String] Özel API taban adresi (varsayılan: https://api.eczaneler.org/v2)
+    # @param timeout [Integer] HTTP okuma zaman aşımı süresi (saniye)
+    # @param open_timeout [Integer] HTTP bağlantı zaman aşımı süresi (saniye)
+    def initialize(api_key, base_url: DEFAULT_BASE_URL, timeout: DEFAULT_TIMEOUT, open_timeout: DEFAULT_OPEN_TIMEOUT)
+      key = api_key.to_s.strip
+      raise AuthenticationError, "API anahtarı boş bırakılamaz." if key.empty?
+
+      @api_key = key
+      @base_url = base_url.to_s.chomp("/")
+      @timeout = timeout
+      @open_timeout = open_timeout
+    end
+
+    # Türkiye ve KKTC genelindeki tüm nöbetçi eczaneleri sayfalı listeler.
+    #
+    # @param page [Integer] Sayfa numarası (varsayılan: 1)
+    # @param limit [Integer] Sayfa başı kayıt sayısı (1 - 50 arası, varsayılan: 25)
+    # @return [ApiResponse] Nöbetçi eczaneleri içeren yanıt modeli
+    def get_sentry_pharmacies(page: 1, limit: 25)
+      valid_page = [1, page.to_i].max
+      valid_limit = [[1, limit.to_i].max, 50].min
+      send_request(:get, "/pharmacies/sentry-pharmacies", query: { page: valid_page, limit: valid_limit }) do |data|
+        (data || []).map { |item| Pharmacy.new(item) }
+      end
+    end
+
+    # Belirli bir ile ait nöbetçi eczaneleri listeler (Örn: city_id: 34 - İstanbul).
+    #
+    # @param city_id [Integer] İl plaka / ID kodu (1 - 82)
+    # @param limit [Integer] Kayıt limiti (1 - 50 arası, varsayılan: 50)
+    # @return [ApiResponse] Nöbetçi eczaneleri içeren yanıt modeli
+    def get_sentry_by_city(city_id, limit: 50)
+      cid = city_id.to_i
+      raise ValidationError, "Geçersiz il ID numarası." if cid <= 0
+
+      valid_limit = [[1, limit.to_i].max, 50].min
+      send_request(:get, "/pharmacies/sentry-city-list/#{cid}", query: { limit: valid_limit }) do |data|
+        (data || []).map { |item| Pharmacy.new(item) }
+      end
+    end
+
+    # Belirli bir il ve ilçeye ait nöbetçi eczaneleri listeler (Örn: city_id: 34, district_id: 440).
+    #
+    # @param city_id [Integer] İl ID kodu
+    # @param district_id [Integer] İlçe ID kodu
+    # @param limit [Integer] Kayıt limiti (1 - 50 arası, varsayılan: 50)
+    # @return [ApiResponse] Nöbetçi eczaneleri içeren yanıt modeli
+    def get_sentry_by_district(city_id, district_id, limit: 50)
+      cid = city_id.to_i
+      did = district_id.to_i
+      raise ValidationError, "Geçersiz il veya ilçe ID numarası." if cid <= 0 || did <= 0
+
+      valid_limit = [[1, limit.to_i].max, 50].min
+      send_request(:get, "/pharmacies/sentry-district-list/#{cid}/#{did}", query: { limit: valid_limit }) do |data|
+        (data || []).map { |item| Pharmacy.new(item) }
+      end
+    end
+
+    # GPS koordinatlarına (enlem ve boylam) göre en yakın eczaneleri mesafeye göre sıralı getirir.
+    #
+    # @param latitude [Float] Enlem (-90.0 .. 90.0)
+    # @param longitude [Float] Boylam (-180.0 .. 180.0)
+    # @param is_sentry [Boolean] Sadece nöbetçi olanlar mı getirilsin? (varsayılan: true)
+    # @param limit [Integer] Kayıt limiti (1 - 50 arası, varsayılan: 10)
+    # @return [ApiResponse] Mesafeye göre sıralı eczaneleri içeren yanıt modeli
+    def get_nearby_pharmacies(latitude:, longitude:, is_sentry: true, limit: 10)
+      lat = latitude.to_f
+      lon = longitude.to_f
+      raise ValidationError, "Geçersiz enlem veya boylam koordinatları." unless (-90.0..90.0).cover?(lat) && (-180.0..180.0).cover?(lon)
+
+      valid_limit = [[1, limit.to_i].max, 50].min
+      body = {
+        lat: lat,
+        lon: lon,
+        is_sentry: is_sentry ? 1 : 0,
+        limit: valid_limit
+      }
+      send_request(:post, "/pharmacies/pharmacies-nearby", body: body) do |data|
+        (data || []).map { |item| Pharmacy.new(item) }
+      end
+    end
+
+    # 81 il ve KKTC il listesini getirir.
+    #
+    # @return [ApiResponse] İl listesini içeren yanıt modeli
+    def get_cities
+      send_request(:get, "/pharmacies/cities") do |data|
+        (data || []).map { |item| City.new(item) }
+      end
+    end
+
+    # Belirli bir ile ait tüm ilçelerin listesini getirir.
+    #
+    # @param city_id [Integer] İl ID kodu (Örn: 34 - İstanbul)
+    # @return [ApiResponse] İlçe listesini içeren yanıt modeli
+    def get_districts(city_id)
+      cid = city_id.to_i
+      raise ValidationError, "Geçersiz il ID numarası." if cid <= 0
+
+      send_request(:get, "/pharmacies/districts/#{cid}") do |data|
+        (data || []).map { |item| District.new(item) }
+      end
+    end
+
+    # API anahtarınıza ait hesap durumu, kalan gün sayısı ve hız limitlerini getirir.
+    #
+    # @return [ApiResponse] Hesap bilgilerini içeren yanıt modeli
+    def get_account_info
+      send_request(:get, "/pharmacies/api-account-info") do |data|
+        data.is_a?(Hash) ? AccountInfo.new(data) : nil
+      end
+    end
+
+    # Güvenlik için izinli IP adresleri listesini (Whitelist) günceller.
+    #
+    # @param ips [String] Virgülle ayrılmış IP adresleri
+    # @return [ApiResponse] İşlem durumunu içeren yanıt modeli
+    def update_whitelist(ips)
+      ip_str = ips.to_s.strip
+      raise ValidationError, "IP adres listesi boş bırakılamaz." if ip_str.empty?
+
+      send_request(:post, "/update-whitelist", body: { ips: ip_str })
+    end
+
+    # [Premium] Türkiye genelindeki tüm kayıtlı eczaneleri sayfalı listeler.
+    #
+    # @param page [Integer] Sayfa numarası (varsayılan: 1)
+    # @param limit [Integer] Sayfa başı limit (1 - 50 arası, varsayılan: 50)
+    # @return [ApiResponse] Eczane listesini içeren yanıt modeli
+    def get_all_pharmacies(page: 1, limit: 50)
+      valid_page = [1, page.to_i].max
+      valid_limit = [[1, limit.to_i].max, 50].min
+      send_request(:get, "/pharmacies/all-pharmacies", query: { page: valid_page, limit: valid_limit }) do |data|
+        (data || []).map { |item| Pharmacy.new(item) }
+      end
+    end
+
+    # [Premium] Belirli bir ildeki tüm eczaneleri listeler.
+    #
+    # @param city_id [Integer] İl ID kodu
+    # @param limit [Integer] Kayıt limiti (1 - 50 arası, varsayılan: 50)
+    # @return [ApiResponse] İldeki tüm eczaneleri içeren yanıt modeli
+    def get_city_pharmacies(city_id, limit: 50)
+      cid = city_id.to_i
+      raise ValidationError, "Geçersiz il ID numarası." if cid <= 0
+
+      valid_limit = [[1, limit.to_i].max, 50].min
+      send_request(:get, "/pharmacies/city-pharmacies/#{cid}", query: { limit: valid_limit }) do |data|
+        (data || []).map { |item| Pharmacy.new(item) }
+      end
+    end
+
+    # [Premium] Belirli bir ilçedeki tüm eczaneleri listeler.
+    #
+    # @param city_id [Integer] İl ID kodu
+    # @param district_id [Integer] İlçe ID kodu
+    # @param limit [Integer] Kayıt limiti (1 - 50 arası, varsayılan: 50)
+    # @return [ApiResponse] İlçedeki tüm eczaneleri içeren yanıt modeli
+    def get_district_pharmacies(city_id, district_id, limit: 50)
+      cid = city_id.to_i
+      did = district_id.to_i
+      raise ValidationError, "Geçersiz il veya ilçe ID numarası." if cid <= 0 || did <= 0
+
+      valid_limit = [[1, limit.to_i].max, 50].min
+      send_request(:get, "/pharmacies/district-pharmacies/#{cid}/#{did}", query: { limit: valid_limit }) do |data|
+        (data || []).map { |item| Pharmacy.new(item) }
+      end
+    end
+
+    private
+
+    def send_request(method, path, query: nil, body: nil, &block)
+      uri = URI.parse("#{@base_url}#{path}")
+      uri.query = URI.encode_www_form(query) if query && !query.empty?
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == "https")
+      http.read_timeout = @timeout
+      http.open_timeout = @open_timeout
+
+      req_class = method == :post ? Net::HTTP::Post : Net::HTTP::Get
+      request = req_class.new(uri.request_uri)
+      request["Accept"] = "application/json"
+      request["Content-Type"] = "application/json"
+      request["X-Api-Key"] = @api_key
+      request["User-Agent"] = USER_AGENT
+
+      request.body = JSON.generate(body) if body
+
+      begin
+        response = http.request(request)
+      rescue StandardError => e
+        raise NetworkError, "Ağ bağlantısı hatası: #{e.message}"
+      end
+
+      parse_response(response, &block)
+    end
+
+    def parse_response(response)
+      status_code = response.code.to_i
+      body_text = response.body.to_s
+
+      parsed_json = nil
+      begin
+        parsed_json = JSON.parse(body_text) if body_text && !body_text.empty?
+      rescue JSON::ParserError
+        parsed_json = nil
+      end
+
+      # Hata durumları
+      if status_code >= 400 || (parsed_json.is_a?(Hash) && parsed_json["status"] == "error")
+        error_msg = parsed_json.is_a?(Hash) ? parsed_json["message"] : "HTTP #{status_code} hatası alındı."
+        error_msg ||= "Bilinmeyen API hatası (HTTP #{status_code})."
+
+        case status_code
+        when 401
+          raise AuthenticationError.new(error_msg, status_code: 401)
+        when 400, 422
+          raise ValidationError.new(error_msg, status_code: status_code)
+        when 404
+          raise NotFoundError.new(error_msg, status_code: 404)
+        when 429
+          raise RateLimitError.new(error_msg, status_code: 429)
+        when 500..599
+          raise ServerError.new(error_msg, status_code: status_code)
+        else
+          raise Error.new(error_msg, status_code: status_code)
+        end
+      end
+
+      raw_data = parsed_json.is_a?(Hash) ? parsed_json["data"] : nil
+      processed_data = block_given? ? yield(raw_data) : raw_data
+
+      pagination_obj = nil
+      if parsed_json.is_a?(Hash) && parsed_json["pagination"].is_a?(Hash)
+        pagination_obj = Pagination.new(parsed_json["pagination"])
+      end
+
+      ApiResponse.new(
+        status: parsed_json.is_a?(Hash) ? parsed_json["status"] : "success",
+        message: parsed_json.is_a?(Hash) ? parsed_json["message"] : nil,
+        data: processed_data,
+        pagination: pagination_obj,
+        total: parsed_json.is_a?(Hash) ? (parsed_json["total"] || pagination_obj&.total) : nil,
+        system_time: parsed_json.is_a?(Hash) ? parsed_json["system_time"] : nil,
+        raw_response: parsed_json
+      )
+    end
+  end
+end

data/lib/nobetci_eczane_api/error.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  # Eczaneler.ORG API genel temel hata sınıfı
+  class Error < StandardError
+    attr_reader :status_code
+
+    def initialize(msg = nil, status_code: nil)
+      @status_code = status_code
+      super(msg)
+    end
+  end
+
+  # API anahtarı eksik veya geçersiz olduğunda fırlatılır (HTTP 401)
+  class AuthenticationError < Error; end
+
+  # Parametre doğrulama hatalarında fırlatılır (HTTP 400 / 422)
+  class ValidationError < Error; end
+
+  # Aranan kayıt bulunamadığında fırlatılır (HTTP 404)
+  class NotFoundError < Error; end
+
+  # Hız limiti aşıldığında fırlatılır (HTTP 429)
+  class RateLimitError < Error; end
+
+  # Sunucu kaynaklı hatalarda fırlatılır (HTTP 500+)
+  class ServerError < Error; end
+
+  # Ağ bağlantısı veya zaman aşımı hatalarında fırlatılır
+  class NetworkError < Error; end
+end

data/lib/nobetci_eczane_api/models/account_info.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  # Hesap ve kota bilgileri modeli
+  class AccountInfo
+    attr_reader :status, :email, :active_package, :days_left, :end_date, :allowed_ips, :rate_limit
+
+    def initialize(attributes = {})
+      attrs = attributes || {}
+      @status = attrs["status"] || attrs[:status]
+      @email = attrs["email"] || attrs[:email]
+      @active_package = attrs["active_package"] || attrs[:active_package]
+      @days_left = (attrs["days_left"] || attrs[:days_left])&.to_i
+      @end_date = attrs["end_date"] || attrs[:end_date]
+      @allowed_ips = attrs["allowed_ips"] || attrs[:allowed_ips]
+      @rate_limit = attrs["rate_limit"] || attrs[:rate_limit]
+    end
+
+    def to_h
+      {
+        status: @status,
+        email: @email,
+        active_package: @active_package,
+        days_left: @days_left,
+        end_date: @end_date,
+        allowed_ips: @allowed_ips,
+        rate_limit: @rate_limit
+      }.compact
+    end
+  end
+end

data/lib/nobetci_eczane_api/models/api_response.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  # API yanıt sarmalayıcısı (Envelope response)
+  class ApiResponse
+    attr_reader :status, :message, :data, :pagination, :total, :system_time, :raw_response
+
+    def initialize(status:, message: nil, data: nil, pagination: nil, total: nil, system_time: nil, raw_response: nil)
+      @status = status
+      @message = message
+      @data = data
+      @pagination = pagination
+      @total = total
+      @system_time = system_time
+      @raw_response = raw_response
+    end
+
+    def success?
+      @status.to_s.casecmp("success").zero? || @status.to_s == "200" || @status.to_s.casecmp("ok").zero?
+    end
+
+    def to_h
+      {
+        status: @status,
+        message: @message,
+        data: @data.is_a?(Array) ? @data.map { |d| d.respond_to?(:to_h) ? d.to_h : d } : (@data.respond_to?(:to_h) ? @data.to_h : @data),
+        pagination: @pagination&.to_h,
+        total: @total,
+        system_time: @system_time
+      }.compact
+    end
+  end
+end

data/lib/nobetci_eczane_api/models/city.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  # İl (Şehir) veri modeli
+  class City
+    attr_reader :id, :name, :slug, :plate, :plate_code, :districts
+
+    def initialize(attributes = {})
+      attrs = attributes || {}
+      @id = (attrs["id"] || attrs[:id]).to_i
+      @name = (attrs["name"] || attrs[:name]).to_s
+      @slug = attrs["slug"] || attrs[:slug]
+      @plate = (attrs["plate"] || attrs["plate_code"] || attrs[:plate] || attrs[:plate_code])&.to_i
+      @plate_code = @plate ? sprintf("%02d", @plate) : nil
+      
+      dist_list = attrs["districts"] || attrs[:districts]
+      @districts = dist_list.is_a?(Array) ? dist_list.map { |d| District.new(d) } : nil
+    end
+
+    def to_h
+      {
+        id: @id,
+        name: @name,
+        slug: @slug,
+        plate: @plate,
+        plate_code: @plate_code,
+        districts: @districts&.map(&:to_h)
+      }.compact
+    end
+  end
+end

data/lib/nobetci_eczane_api/models/district.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  # İlçe veri modeli
+  class District
+    attr_reader :id, :city_id, :name, :slug
+
+    def initialize(attributes = {})
+      attrs = attributes || {}
+      @id = (attrs["id"] || attrs[:id]).to_i
+      @city_id = (attrs["city_id"] || attrs[:city_id])&.to_i
+      @name = (attrs["name"] || attrs[:name]).to_s
+      @slug = attrs["slug"] || attrs[:slug]
+    end
+
+    def to_h
+      {
+        id: @id,
+        city_id: @city_id,
+        name: @name,
+        slug: @slug
+      }.compact
+    end
+  end
+end

data/lib/nobetci_eczane_api/models/location.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  # Eczane coğrafi konum ve harita yönlendirme bilgileri
+  class Location
+    attr_reader :latitude, :longitude, :google_maps_url, :yandex_maps_url, :apple_maps_url, :distance_meters, :distance_km
+
+    def initialize(attributes = {})
+      attrs = attributes || {}
+      @latitude = (attrs["latitude"] || attrs[:latitude])&.to_f
+      @longitude = (attrs["longitude"] || attrs[:longitude])&.to_f
+      @google_maps_url = attrs["google_maps_url"] || attrs[:google_maps_url]
+      @yandex_maps_url = attrs["yandex_maps_url"] || attrs[:yandex_maps_url]
+      @apple_maps_url = attrs["apple_maps_url"] || attrs[:apple_maps_url]
+      @distance_meters = (attrs["distance_meters"] || attrs[:distance_meters])&.to_f
+      @distance_km = (attrs["distance_km"] || attrs[:distance_km])&.to_f
+    end
+
+    def to_h
+      {
+        latitude: @latitude,
+        longitude: @longitude,
+        google_maps_url: @google_maps_url,
+        yandex_maps_url: @yandex_maps_url,
+        apple_maps_url: @apple_maps_url,
+        distance_meters: @distance_meters,
+        distance_km: @distance_km
+      }.compact
+    end
+  end
+end

data/lib/nobetci_eczane_api/models/pagination.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  # Sayfalama meta verileri modeli
+  class Pagination
+    attr_reader :total, :total_pages, :current_page, :per_page, :has_more, :has_prev_page, :prev_page, :next_page
+
+    def initialize(attributes = {})
+      attrs = attributes || {}
+      @total = attrs["total"] || attrs["total_records"] || attrs[:total] || attrs[:total_records]
+      @total_pages = attrs["total_pages"] || attrs[:total_pages]
+      @current_page = attrs["current_page"] || attrs[:current_page]
+      @per_page = attrs["per_page"] || attrs["limit"] || attrs[:per_page] || attrs[:limit]
+      @has_more = attrs.key?("has_more") ? attrs["has_more"] : (attrs.key?("has_next_page") ? attrs["has_next_page"] : attrs[:has_more])
+      @has_prev_page = attrs["has_prev_page"] || attrs[:has_prev_page]
+      @prev_page = attrs["prev_page"] || attrs[:prev_page]
+      @next_page = attrs["next_page"] || attrs[:next_page]
+    end
+
+    def to_h
+      {
+        total: @total,
+        total_pages: @total_pages,
+        current_page: @current_page,
+        per_page: @per_page,
+        has_more: @has_more,
+        has_prev_page: @has_prev_page,
+        prev_page: @prev_page,
+        next_page: @next_page
+      }.compact
+    end
+  end
+end

data/lib/nobetci_eczane_api/models/pharmacy.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  # Eczane / Nöbetçi Eczane detay veri modeli
+  class Pharmacy
+    attr_reader :id, :name, :slug, :address, :address_description, :phone, :phone2,
+                :duty_start, :duty_end, :duty_note, :is_sentry, :working_hours,
+                :city_id, :city, :city_name, :city_slug, :district_id, :district,
+                :district_name, :district_slug, :locality, :neighborhood, :directions,
+                :latitude, :longitude, :map_link, :distance_km, :location
+
+    def initialize(attributes = {})
+      attrs = attributes || {}
+      @id = (attrs["id"] || attrs[:id]).to_i
+      @name = (attrs["name"] || attrs[:name]).to_s
+      @slug = attrs["slug"] || attrs[:slug]
+      @address = attrs["address"] || attrs[:address]
+      @address_description = attrs["address_description"] || attrs["address_desc"] || attrs[:address_description] || attrs[:address_desc]
+      @phone = attrs["phone"] || attrs[:phone]
+      @phone2 = attrs["phone2"] || attrs[:phone2]
+      @duty_start = attrs["duty_start"] || attrs[:duty_start]
+      @duty_end = attrs["duty_end"] || attrs[:duty_end]
+      @duty_note = attrs["duty_note"] || attrs[:duty_note]
+      
+      sentry_val = attrs.key?("is_sentry") ? attrs["is_sentry"] : attrs[:is_sentry]
+      @is_sentry = [true, 1, "1", "true", "TRUE"].include?(sentry_val)
+      
+      @working_hours = attrs["working_hours"] || attrs["workingHours"] || attrs[:working_hours] || attrs[:workingHours]
+      @city_id = (attrs["city_id"] || attrs[:city_id])&.to_i
+      @city = attrs["city"] || attrs["city_name"] || attrs[:city] || attrs[:city_name]
+      @city_name = @city
+      @city_slug = attrs["city_slug"] || attrs[:city_slug]
+      @district_id = (attrs["district_id"] || attrs[:district_id])&.to_i
+      @district = attrs["district"] || attrs["district_name"] || attrs[:district] || attrs[:district_name]
+      @district_name = @district
+      @district_slug = attrs["district_slug"] || attrs[:district_slug]
+      @locality = attrs["locality"] || attrs["neighborhood"] || attrs[:locality] || attrs[:neighborhood]
+      @neighborhood = @locality
+      @directions = attrs["directions"] || attrs[:directions]
+      @map_link = attrs["map_link"] || attrs[:map_link]
+      @distance_km = (attrs["distance_km"] || attrs[:distance_km])&.to_f
+
+      # Coordinates parsing
+      lat_val = attrs["latitude"] || attrs[:latitude]
+      lon_val = attrs["longitude"] || attrs[:longitude]
+      if (lat_val.nil? || lon_val.nil?) && (attrs["coordinates"] || attrs[:coordinates]).is_a?(Hash)
+        coords = attrs["coordinates"] || attrs[:coordinates]
+        lat_val ||= coords["lat"] || coords[:lat]
+        lon_val ||= coords["lng"] || coords[:lng]
+      end
+      @latitude = lat_val&.to_f
+      @longitude = lon_val&.to_f
+
+      loc_data = attrs["location"] || attrs[:location]
+      @location = loc_data.is_a?(Hash) ? Location.new(loc_data) : nil
+    end
+
+    def to_h
+      {
+        id: @id,
+        name: @name,
+        slug: @slug,
+        address: @address,
+        address_description: @address_description,
+        phone: @phone,
+        phone2: @phone2,
+        duty_start: @duty_start,
+        duty_end: @duty_end,
+        duty_note: @duty_note,
+        is_sentry: @is_sentry,
+        working_hours: @working_hours,
+        city_id: @city_id,
+        city: @city,
+        city_name: @city_name,
+        city_slug: @city_slug,
+        district_id: @district_id,
+        district: @district,
+        district_name: @district_name,
+        district_slug: @district_slug,
+        locality: @locality,
+        neighborhood: @neighborhood,
+        directions: @directions,
+        latitude: @latitude,
+        longitude: @longitude,
+        map_link: @map_link,
+        distance_km: @distance_km,
+        location: @location&.to_h
+      }.compact
+    end
+  end
+end

data/lib/nobetci_eczane_api/models.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative "models/api_response"
+require_relative "models/pagination"
+require_relative "models/location"
+require_relative "models/district"
+require_relative "models/city"
+require_relative "models/pharmacy"
+require_relative "models/account_info"

data/lib/nobetci_eczane_api/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module NobetciEczaneApi
+  VERSION = "1.0.0"
+end

data/lib/nobetci_eczane_api.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative "nobetci_eczane_api/version"
+require_relative "nobetci_eczane_api/error"
+require_relative "nobetci_eczane_api/models"
+require_relative "nobetci_eczane_api/client"
+
+module NobetciEczaneApi
+  class << self
+    # Kolay client başlatıcı
+    #
+    # @param api_key [String]
+    # @return [NobetciEczaneApi::Client]
+    def new(api_key, **options)
+      Client.new(api_key, **options)
+    end
+  end
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: nobetci_eczane_api
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Mehmet Erdoğan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-09-24 00:00:00.000000000 Z
+dependencies: []
+description: Türkiye (81 il) ve KKTC genelindeki tüm güncel nöbetçi eczaneler, il/ilçe
+  eczane listeleri ve GPS koordinat bazlı en yakın eczane sorguları için resmi Ruby
+  SDK kütüphanesi.
+email:
+- mehmeterdogan080@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/nobetci_eczane_api.rb
+- lib/nobetci_eczane_api/client.rb
+- lib/nobetci_eczane_api/error.rb
+- lib/nobetci_eczane_api/models.rb
+- lib/nobetci_eczane_api/models/account_info.rb
+- lib/nobetci_eczane_api/models/api_response.rb
+- lib/nobetci_eczane_api/models/city.rb
+- lib/nobetci_eczane_api/models/district.rb
+- lib/nobetci_eczane_api/models/location.rb
+- lib/nobetci_eczane_api/models/pagination.rb
+- lib/nobetci_eczane_api/models/pharmacy.rb
+- lib/nobetci_eczane_api/version.rb
+homepage: https://eczaneler.org/nobetci-eczane-api
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://eczaneler.org/nobetci-eczane-api
+  source_code_uri: https://github.com/mehmeterdogan/nobetci-eczane-api-ruby
+  changelog_uri: https://github.com/mehmeterdogan/nobetci-eczane-api-ruby/releases
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Eczaneler.ORG v2 Nöbetçi Eczane REST API Resmi Ruby SDK
+test_files: []