{
    "slug": "sound-catalog",
    "name": "Sound Catalog",
    "summary": "MyInstants kaynaklı kısa ses efektleri; aranabilir, sayfalı, kaynak listeye göre süzülebilir düz liste.",
    "description": "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.",
    "version": "2.0.0",
    "status": "beta",
    "updated": "2026-10-07",
    "methods": [
        "GET"
    ],
    "format": "json",
    "auth": "none",
    "tags": [
        "sound",
        "audio",
        "mp3",
        "myinstants",
        "effects"
    ],
    "consumers": [
        "Launcher",
        "Falcon"
    ],
    "endpoint": "https://api.streamember.com/sound-catalog/",
    "docs_html": "https://api.streamember.com/?docs=sound-catalog",
    "docs_markdown": "https://api.streamember.com/sound-catalog/API.md",
    "manifest_json": "https://api.streamember.com/?docs=sound-catalog&format=json",
    "pages": [
        {
            "title": "Veri üretimi (scraper)",
            "markdown": "https://api.streamember.com/sound-catalog/README.md",
            "html": "https://api.streamember.com/?docs=sound-catalog&page=README.md"
        }
    ],
    "examples": [
        {
            "title": "İlk sayfa",
            "url": "https://api.streamember.com/sound-catalog/?per_page=20"
        },
        {
            "title": "Arama",
            "url": "https://api.streamember.com/sound-catalog/?q=bruh"
        },
        {
            "title": "Yalnızca Japonca listede geçen sesler",
            "url": "https://api.streamember.com/sound-catalog/?source=ja&per_page=20"
        }
    ],
    "body_markdown": "## Genel bakış\n\nYanı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.\n\nMevcut 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).\n\n## Hızlı başlangıç\n\n```text\nGET https://api.streamember.com/sound-catalog/?q=alarm&per_page=20\n```\n\n```json\n[\n  { \"id\": \"bruh\", \"name\": \"BRUH\", \"url\": \"https://www.myinstants.com/media/sounds/movie_1.mp3\",\n    \"sources\": [\"en\", \"de\", \"ru\"] }\n]\n```\n\n## Parametreler\n\n| Parametre | Tür | Varsayılan | Açıklama |\n|---|---|---|---|\n| `q` | metin | — | Ad, kimlik ve dosya adında aksan duyarsız arama |\n| `source` | liste | tümü | Kaynak liste kodları, ör. `ja,ko` |\n| `page` | sayı | `1` | Sayfa |\n| `per_page` | sayı | `100` | Sayfa boyutu (en fazla 100) |\n\n## Yanıt biçimi\n\nDizi; 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`.\n\n## Hatalar\n\n| HTTP | `error` | Ne zaman |\n|---|---|---|\n| 405 | `method_not_allowed` | GET dışı istek |\n| 500 | `internal_error` | `data/catalog.json` okunamadı ya da bozuk |\n| 503 | `catalog_missing` | Katalog henüz üretilmemiş |\n\n## Önbellek ve sınırlar\n\nDü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.\n\n## Değişiklik geçmişi\n\n- **2.0.0** — `source` filtresi ve `sources` alanı, standart hata biçimi, `ETag`, API.md.\n"
}