REST API v1.0 · Public & Academic

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

ÇOMÜ Yer Bilimleri ve Doğa Tarihi 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

API Base URL

https://ybm.org.tr/web/api/v1

CORS: Destekleniyor (*)

Format: JSON

Erişim: Açık & Ücretsiz (60 req/min)

Hızlı & Güvenli

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

Akademik Standartlar

Darwin Core (DwC) paleontolojik ve Dublin Core (DC) meta veri standartları ile uluslararası veri entegrasyonu.

Otomatik Atıf

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

REST API Uç Noktaları (Endpoints)

Aşağıdaki uç noktaları GET istekleriyle doğrudan JSON formatında çağırabilirsiniz.

v1 Sürümü

GET /api/v1/objects

Canlı JSON Dene

Eserleri / Numuneleri Listele

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

Parametre	Tip	Açıklama
`category_id`	integer	Kategori ID ile filtreleme (örn: 1)
`search`	string	İsim, envanter no veya konumda kelime arama
`page`	integer	Sayfa numarası (varsayılan: 1)
`per_page`	integer	Sayfa başına kayıt (varsayılan: 15, maks: 50)

# cURL Örneği
curl -X GET "https://ybm.org.tr/web/api/v1/objects?per_page=3" \
-H "Accept: application/json"

GET /api/v1/objects/{id}

Canlı JSON Dene

Eser / Numune Detayı & Darwin Core

Eserin temel, bilimsel, konum ve uluslararası standart (Darwin Core & Dublin Core) verilerini döndürür. Sayısal ID veya kalıcı PID kabul eder.

Parametre	Tip	Açıklama
`id`	int/string	Eser ID (örn: 1) veya Kalıcı PID (örn: YBM-M101)

# cURL Örneği
curl -X GET "https://ybm.org.tr/web/api/v1/objects/1" \
-H "Accept: application/json"

GET /api/v1/categories

Canlı JSON Dene

Koleksiyon Kategorilerini Listele

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

# cURL Örneği
curl -X GET "https://ybm.org.tr/web/api/v1/categories" \
-H "Accept: application/json"

GET /api/v1/objects/{id}/citation

Canlı JSON Dene

Akademik Atıf Verileri

İlgili numune 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.

Parametre	Tip	Açıklama
`id`	int/string	Eser ID veya PID

# cURL Örneği
curl -X GET "https://ybm.org.tr/web/api/v1/objects/1/citation" \
-H "Accept: application/json"

GET /api/v1/objects/{id}/stories

Canlı JSON Dene

Eser Hikâyeleri & Anlatıları

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

Parametre	Tip	Açıklama
`id`	int/string	Eser ID veya PID

# cURL Örneği
curl -X GET "https://ybm.org.tr/web/api/v1/objects/1/stories" \
-H "Accept: application/json"

GET /api/v1/objects/{id}/ratings

Canlı JSON Dene

Derecelendirme & Puan İstatistikleri

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

Parametre	Tip	Açıklama
`id`	int/string	Eser ID veya PID

# cURL Örneği
curl -X GET "https://ybm.org.tr/web/api/v1/objects/1/ratings" \
-H "Accept: application/json"

Uluslararası Açık Veri Standartları

Darwin Core (DwC) & Dublin Core (DC) Uyumu

Müzemiz API'si; GBIF (Global Biodiversity Information Facility), Europeana ve küresel araştırma ağları ile doğrudan entegrasyon için Darwin Core ve Dublin Core alan eşleştirmelerini standart olarak sunar.

Darwin Core (DwC) Şeması

Paleontolojik ve mineralojik numune taksonomisi.

"darwin_core": {
  "dwc:basisOfRecord": "PreservedSpecimen",
  "dwc:catalogNumber": "M101",
  "dwc:scientificName": "Kuvars (Quartz)",
  "dwc:decimalLatitude": 40.119,
  "dwc:decimalLongitude": 26.414,
  "dwc:locality": "Biga Yarımadası"
}

Dublin Core (DC) Şeması

Dijital kütüphane ve kalıcı koleksiyon meta verisi.

"dublin_core": {
  "dc:title": "Kuvars Kristali",
  "dc:identifier": "YBM-M101",
  "dc:publisher": "ÇOMÜ Yer Bilimleri Müzesi",
  "dc:type": "PhysicalObject",
  "dc:rights": "Açık Erişim / CC BY-NC 4.0"
}