{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://zieapi.vercel.app"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/indonesia:quran-kemenag/surah-list":{"get":{"operationId":"indonesia_quran_kemenag_surah_list","summary":"Daftar Surat","description":"Daftar 114 surat dengan filter nama dan tempat turun.","tags":["indonesia"],"parameters":[{"name":"keyword","in":"query","required":false,"description":"Filter nama latin / arti surat","schema":{"type":"string","description":"Filter nama latin / arti surat"},"example":"baqarah"},{"name":"revelation","in":"query","required":false,"schema":{"type":"string","enum":["all","makkiyah","madaniyah"],"default":"all"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":114,"minimum":1,"maximum":114}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/indonesia:quran-kemenag/surah-detail":{"get":{"operationId":"indonesia_quran_kemenag_surah_detail","summary":"Detail Surat","description":"Info surat lengkap dengan seluruh ayatnya.","tags":["indonesia"],"parameters":[{"name":"surah","in":"query","required":true,"description":"Nomor surat (1–114)","schema":{"type":"integer","minimum":1,"maximum":114,"description":"Nomor surat (1–114)"},"example":1}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/indonesia:quran-kemenag/ayah-list":{"get":{"operationId":"indonesia_quran_kemenag_ayah_list","summary":"Daftar Ayat","description":"Ayat-ayat dalam satu surat, dengan paginasi.","tags":["indonesia"],"parameters":[{"name":"surah","in":"query","required":true,"description":"Nomor surat (1–114)","schema":{"type":"integer","minimum":1,"maximum":114,"description":"Nomor surat (1–114)"},"example":1},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":286}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/indonesia:quran-kemenag/ayah-detail":{"get":{"operationId":"indonesia_quran_kemenag_ayah_detail","summary":"Detail Ayat","description":"Satu ayat: teks Arab, latin, terjemahan, dan audio.","tags":["indonesia"],"parameters":[{"name":"surah","in":"query","required":true,"description":"Nomor surat (1–114)","schema":{"type":"integer","minimum":1,"maximum":114,"description":"Nomor surat (1–114)"},"example":1},{"name":"ayah","in":"query","required":true,"description":"Nomor ayat","schema":{"type":"integer","minimum":1,"maximum":286,"description":"Nomor ayat"},"example":1}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/indonesia:quran-kemenag/tafsir-ayah":{"get":{"operationId":"indonesia_quran_kemenag_tafsir_ayah","summary":"Tafsir Ayat","description":"Tafsir Kemenag per ayat. Tanpa parameter ayah, mengembalikan tafsir seluruh surat.","tags":["indonesia"],"parameters":[{"name":"surah","in":"query","required":true,"description":"Nomor surat (1–114)","schema":{"type":"integer","minimum":1,"maximum":114,"description":"Nomor surat (1–114)"},"example":1},{"name":"ayah","in":"query","required":false,"description":"Nomor ayat (opsional)","schema":{"type":"integer","minimum":1,"maximum":286,"description":"Nomor ayat (opsional)"},"example":1}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/indonesia:quran-kemenag/random-ayah":{"get":{"operationId":"indonesia_quran_kemenag_random_ayah","summary":"Ayat Acak","description":"Satu ayat acak (opsional dari surat tertentu).","tags":["indonesia"],"parameters":[{"name":"surah","in":"query","required":false,"description":"Batasi ke surat ini (opsional)","schema":{"type":"integer","minimum":1,"maximum":114,"description":"Batasi ke surat ini (opsional)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}