REST API v1.0 · Public & Academic

YBM Open Museum Data & REST API

We open mineral, rock, fossil, and natural history specimens in ÇOMÜ Museum collections to global standards for academic research, mobile/web apps, and institutional integrations.

Explore Endpoints Darwin & Dublin Core

API Base URL

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

CORS: Destekleniyor (*)

Format: JSON

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

Fast & Secure

Access all public catalog data with CORS support in JSON format at high speeds with a rate limit of 60 requests per minute.

Academic Standards

International data integration adhering to Darwin Core (DwC) paleontological and Dublin Core (DC) metadata standards.

Automated Citation

Instant dynamic export support for each artifact in BibTeX, APA, Chicago, RIS, and plain text formats.

REST API Endpoints

You can invoke the following endpoints directly using GET requests in JSON format.

v1 Sürümü

GET /api/v1/objects

Try Live JSON

Eserleri / Numuneleri Listele

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

Parameter	Type	Description
`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://mail.ybm.org.tr/web/api/v1/objects?per_page=3" \
-H "Accept: application/json"

GET /api/v1/objects/{id}

Try Live JSON

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.

Parameter	Type	Description
`id`	int/string	Eser ID (örn: 1) veya Kalıcı PID (örn: YBM-M101)

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

GET /api/v1/categories

Try Live JSON

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://mail.ybm.org.tr/web/api/v1/categories" \
-H "Accept: application/json"

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

Try Live JSON

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.

Parameter	Type	Description
`id`	int/string	Eser ID veya PID

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

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

Try Live JSON

Eser Hikâyeleri & Anlatıları

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

Parameter	Type	Description
`id`	int/string	Eser ID veya PID

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

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

Try Live JSON

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.

Parameter	Type	Description
`id`	int/string	Eser ID veya PID

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

International Open Data Standards

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

Our museum API provides native Darwin Core and Dublin Core field mappings for seamless integration with GBIF, Europeana, and international research repositories.

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"
}