{
    "slug": "lottie-animations",
    "name": "Lottie Animations",
    "summary": "Overlay ve oyun içi efektler için Lottie animasyon kütüphanesi; genel ve hediye grupları, arama ve 14 dilde grup adları.",
    "description": "Sunucuda barındırılan Lottie (JSON) animasyonlarını grup bazında listeler. Animasyon dosyaları api.streamember.com üzerinden doğrudan indirilir. Platform hediye listesi değildir; hediyeler için platform-events.",
    "version": "2.0.0",
    "status": "stable",
    "updated": "2026-10-07",
    "methods": [
        "GET"
    ],
    "format": "json",
    "auth": "none",
    "tags": [
        "lottie",
        "animation",
        "overlay",
        "gifts"
    ],
    "consumers": [
        "Launcher",
        "Falcon"
    ],
    "endpoint": "https://api.streamember.com/lottie-animations/",
    "docs_html": "https://api.streamember.com/?docs=lottie-animations",
    "docs_markdown": "https://api.streamember.com/lottie-animations/API.md",
    "manifest_json": "https://api.streamember.com/?docs=lottie-animations&format=json",
    "pages": [
        {
            "title": "Veri üretimi (indirme aracı)",
            "markdown": "https://api.streamember.com/lottie-animations/README.md",
            "html": "https://api.streamember.com/?docs=lottie-animations&page=README.md"
        }
    ],
    "examples": [
        {
            "title": "Her gruptan 10 kayıt",
            "url": "https://api.streamember.com/lottie-animations/?summary=1&lang=en",
            "description": "Yapıyı öğrenmek için önerilen ilk istek."
        },
        {
            "title": "Hediye animasyonları",
            "url": "https://api.streamember.com/lottie-animations/?group=gifts&lang=tr"
        },
        {
            "title": "Arama",
            "url": "https://api.streamember.com/lottie-animations/?q=heart&lang=tr"
        }
    ],
    "body_markdown": "## Genel bakış\n\nKütüphane iki gruptan oluşur: `general` (LottieFiles kaynaklı genel animasyonlar) ve `gifts` (hediye efektleri). Liste `data/manifest.json` dosyasından okunur; dosyalar `animations/{group}/{vendor}/` altındadır ve `url` alanı tam adres olarak döner.\n\n## Hızlı başlangıç\n\n```text\nGET https://api.streamember.com/lottie-animations/?summary=1&lang=tr\n```\n\n```json\n[\n  {\n    \"group\": \"general\",\n    \"name\": \"Genel animasyonlar\",\n    \"count\": 161,\n    \"items\": [\n      { \"id\": \"general:lottiefiles:42027-2021\", \"name\": \"2021\", \"vendor\": \"lottiefiles\",\n        \"url\": \"https://api.streamember.com/lottie-animations/animations/general/lottiefiles/42027-2021.json\", \"bytes\": 740587 }\n    ]\n  }\n]\n```\n\n## Parametreler\n\n| Parametre | Tür | Varsayılan | Açıklama |\n|---|---|---|---|\n| `lang` | metin | `tr` | Grup adlarının dili; 14 dil kodundan birine çözülür (bkz. locale-catalog). |\n| `group` | liste | tümü | `general`, `gifts` |\n| `vendor` | liste | tümü | `lottiefiles`, `younowgifts` |\n| `q` | metin | — | Ad ya da kimlikte arama |\n| `summary` | bool | `0` | Her gruptan ilk 10 kayıt |\n| `limit` / `page` | sayı | `250` / `1` | Grup başına sayfalama (`limit` ≤ 1000) |\n\n## Yanıt biçimi\n\nDizi; her öğe bir gruptur: `group`, `name` (istenen dilde), `count` (filtre sonrası toplam), `items`. Öğe alanları: `id`, `name`, `vendor`, `url`, `bytes`. Toplam kayıt `X-Total-Count` başlığında.\n\n## Hatalar\n\n| HTTP | `error` | Ne zaman |\n|---|---|---|\n| 400 | `invalid_parameter` | Bilinmeyen `group` |\n| 405 | `method_not_allowed` | GET dışı istek |\n| 503 | `manifest_missing` | `data/manifest.json` henüz üretilmemiş |\n\n## Önbellek ve sınırlar\n\n`Cache-Control: public, max-age=21600` ve manifest değiştiğinde değişen `ETag`.\n\n## Değişiklik geçmişi\n\n- **2.0.0** — 14 dil, `q`/`vendor`/`group`/`limit`/`page` parametreleri, standart hata biçimi; URL'ler `api.streamember.com` adresinden ve manifestteki `path` alanından üretilir; dosya önbelleği kaldırıldı.\n"
}