YBM
Admin Panel
REST API v1.0 · Public & Academic

YBM Açık Müze Veri & REST API

ÇOMÜ Yer Bilimleri Müzesi koleksiyonlarındaki mineral, kayaç, fosil ve doğa tarihi numunelerini akademik araştırmalar, mobil/web uygulamaları ve kurumsal entegrasyonlar için dünya standartlarında açıyoruz.

Uç Noktaları İncele Darwin & Dublin Core Standartları

Hızlı & Güvenli

Tüm genel katalog verilerine CORS destekli ve JSON formatında dakikada 60 istek sınırı ile erişebilirsiniz.

Akademik Standartlar

Darwin Core (DwC) biyolojik ve paleontolojik alanlar ile Dublin Core (DC) meta veri şemaları hazır olarak sunulur.

Otomatik Atıf

Her eser için anında BibTeX, APA, Chicago, RIS ve düz metin formatında dışa aktarım desteği.

Temel İstek Bilgileri

Base URL https://ybm.org.tr/web/api/v1
Varsayılan Başlıklar (Headers) Accept: application/json
X-API-Key: {opsiyonel_anahtar}

REST API Uç Noktaları (Endpoints)

Versiyon: v1
GET /api/v1/objects
Canlı Dene ↗

Eserleri / Numuneleri Listele

Yayınlanmış tüm eserleri sayfalanmış olarak listeler. Kategori ve arama filtrelerini destekler.

Parametreler
  • category_id: Kategori ID ile filtreleme (örn: 1)
  • search: İsim, envanter no veya konumda anahtar kelime arama
  • page: Sayfa numarası (varsayılan: 1)
  • per_page: Sayfa başına kayıt (varsayılan: 15, maks: 50)
GET /api/v1/objects/{id}
Canlı Dene ↗

Eser / Numune Detayı

Eserin temel, bilimsel, konum ve uluslararası standart (Darwin/Dublin Core) verilerini döndürür. Parametre olarak sayısal ID veya kalıcı PID (örn: YBM-M101) alabilir.

Parametreler
  • id: Eser ID (örn: 317) veya Kalıcı PID (örn: YBM-M101)
GET /api/v1/categories
Canlı Dene ↗

Koleksiyon Kategorilerini Listele

Tüm ana koleksiyon kategorilerini (Mineraller, Fosiller, Kayaçlar vb.) eser sayılarıyla döndürür.

GET /api/v1/objects/{id}/citation
Canlı Dene ↗

Akademik Atıf Verileri

İlgili eser için dinamik üretilmiş BibTeX, APA, Chicago, RIS ve Plain Text atıf kayıtlarını ve indirme bağlantılarını döndürür.

Parametreler
  • id: Eser ID veya PID
GET /api/v1/objects/{id}/stories
Canlı Dene ↗

Eser Hikâyeleri (Storytelling)

Eser hakkında editör tarafından onaylanmış jeolojik/tarihsel hikâyeleri ve anlatımları döndürür.

Parametreler
  • id: Eser ID veya PID
GET /api/v1/objects/{id}/ratings
Canlı Dene ↗

Derecelendirme İstatistikleri

Eserin ortalama puanını (1-5), oy sayısını ve yıldız bazlı dağılımını döndürür.

Parametreler
  • id: Eser ID veya PID

Uluslararası Açık Veri & Müze Standartları

YBM REST API'si, GBIF (Global Biodiversity Information Facility), Europeana ve doğa tarihi koleksiyonlarıyla uyum için Darwin Core ve Dublin Core alan eşleştirmelerini nesne detayında (/api/v1/objects/{id}) hazır sunmaktadır:

Darwin Core (DwC) Alanları

Doğa tarihi, zoolojik ve paleontolojik numune taksonomisi.

"darwin_core": {
  "dwc:basisOfRecord": "PreservedSpecimen",
  "dwc:catalogNumber": "M101",
  "dwc:scientificName": "Opal",
  "dwc:decimalLatitude": 39.143,
  "dwc:decimalLongitude": 28.977,
  "dwc:locality": "Simav"
}

Dublin Core (DC) Alanları

Akademik kütüphane ve dijital koleksiyon meta verisi.

"dublin_core": {
  "dc:title": "Opal",
  "dc:identifier": "YBM-M101",
  "dc:publisher": "ÇOMÜ Yer Bilimleri Müzesi (YBM)",
  "dc:type": "PhysicalObject",
  "dc:coverage": "Simav"
}