Sound Catalog
Tetikleyicilerde çalınacak kısa ses efektlerini döndürür. Sesler MyInstants'ın ülke/dil listelerinden toplanır, aynı ses tek kayıt olarak tutulur. MP3 dosyaları proxy edilmez; url doğrudan kaynaktır.
Hızlı başvuru
| Örnek istek | Yol (API klasörüne göre) |
|---|---|
| İlk sayfa | ?per_page=20 |
| Arama | ?q=bruh |
| Yalnızca Japonca listede geçen sesler | ?source=ja&per_page=20 |
- Kullananlar
- Launcher, Falcon
- Etiketler
- sound, audio, mp3, myinstants, effects
- Doküman (ham)
- api.streamember.com/sound-catalog/API.md
- Ek sayfalar
- Veri üretimi (scraper)
Genel bakış
Yanıt düz bir ses dizisidir; sayfalama bilgisi başlıklarda taşınır. Ses adları kaynaktaki haliyle döner (çevrilmez), bu yüzden bu API lang parametresi almaz. source, sesin hangi MyInstants listesinde göründüğünü süzer.
Mevcut kaynak listeleri: en, de, pt, es, fr, nl, hi, it, ja, ko, ru. Türkçe (tr) ve diğer ekosistem dilleri henüz toplanmadı (bkz. README).
Hızlı başlangıç
GET https://api.streamember.com/sound-catalog/?q=alarm&per_page=20[
{ "id": "bruh", "name": "BRUH", "url": "https://www.myinstants.com/media/sounds/movie_1.mp3",
"sources": ["en", "de", "ru"] }
]Parametreler
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
q | metin | — | Ad, kimlik ve dosya adında aksan duyarsız arama |
source | liste | tümü | Kaynak liste kodları, ör. ja,ko |
page | sayı | 1 | Sayfa |
per_page | sayı | 100 | Sayfa boyutu (en fazla 100) |
Yanıt biçimi
Dizi; alanlar: id, name, url (doğrudan MP3), sources (sesin geçtiği kaynak listeler). Başlıklar: X-Total-Count, X-Page, X-Per-Page, X-Total-Pages, ETag.
Hatalar
| HTTP | error | Ne zaman |
|---|---|---|
| 405 | method_not_allowed | GET dışı istek |
| 500 | internal_error | data/catalog.json okunamadı ya da bozuk |
| 503 | catalog_missing | Katalog henüz üretilmemiş |
Önbellek ve sınırlar
Düzleştirilmiş arama indeksi cache/sounds-index-v2.json dosyasında 6 saat tutulur; catalog.json değişince yeniden üretilir. Yanıtlar Cache-Control: public, max-age=3600 ve ETag taşır.
Değişiklik geçmişi
- 2.0.0 —
sourcefiltresi vesourcesalanı, standart hata biçimi,ETag, API.md.