{"openapi":"3.0.3","info":{"title":"MangaDar API","version":"1.0.1","description":"واجهة metadata عامة لمصدر MangaDar. للحصول على صفحات فصل: خذ item.chapters[].url ثم مرره إلى /api/v1/chapters?url=..."},"servers":[{"url":"/"}],"paths":{"/api/v1/health":{"get":{"summary":"فحص حالة الخدمة","description":"فحص حالة الخدمة","parameters":[],"responses":{"200":{"description":"فحص حالة الخدمة"}}}},"/api/v1/manga":{"get":{"summary":"تصفح وبحث وفلاتر المانجا","description":"استخدم q للبحث وgenre=70 للفضاء وpage وlimit للترقيم.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"بحث بالاسم"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"sort","in":"query","schema":{"type":"string","enum":["latest","views","rating","az"]}},{"name":"genre","in":"query","schema":{"type":"string"},"description":"معرّف التصنيف، مثال genre=70 للفضاء"},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"استخدم q للبحث وgenre=70 للفضاء وpage وlimit للترقيم."}}}},"/api/v1/search":{"get":{"summary":"بحث بالاسم","description":"بحث بالاسم","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"doctor"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"sort","in":"query","schema":{"type":"string","enum":["latest","views","rating","az"]}},{"name":"genre","in":"query","schema":{"type":"string"},"description":"معرّف التصنيف، مثال genre=70 للفضاء"},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"بحث بالاسم"}}}},"/api/v1/manga/{slug}":{"get":{"summary":"تفاصيل مانجا وفصولها","description":"يعيد item.chapters[] مع url الأصلي لكل فصل.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"planetes"}],"responses":{"200":{"description":"يعيد item.chapters[] مع url الأصلي لكل فصل."}}}},"/api/v1/manga/{slug}/chapters":{"get":{"summary":"قائمة فصول مانجا","description":"قائمة فصول مانجا","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"planetes"}],"responses":{"200":{"description":"قائمة فصول مانجا"}}}},"/api/v1/chapters":{"get":{"summary":"جلب صفحات فصل من رابطه الأصلي","description":"مرر رابط الفصل كما ظهر في item.chapters[].url. يعيد pages مرتبة ولا يستضيف الصور.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"example":"https://mangadar.com/manga/planetes/chapter-1/"}],"responses":{"200":{"description":"مرر رابط الفصل كما ظهر في item.chapters[].url. يعيد pages مرتبة ولا يستضيف الصور."}}}},"/api/v1/chapter":{"get":{"summary":"اسم بديل لجلب صفحات فصل","description":"اسم بديل لجلب صفحات فصل","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"}}],"responses":{"200":{"description":"اسم بديل لجلب صفحات فصل"}}}},"/api/v1/chapters/{slug}":{"get":{"summary":"مسار توافق قديم للفصل","description":"يفضل استخدام /api/v1/chapters?url= بالرابط الأصلي.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"يفضل استخدام /api/v1/chapters?url= بالرابط الأصلي."}}}},"/api/v1/latest/chapters":{"get":{"summary":"آخر الفصول المضافة","description":"آخر الفصول المضافة","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"آخر الفصول المضافة"}}}},"/api/v1/latest/manga":{"get":{"summary":"آخر الأعمال المضافة","description":"آخر الأعمال المضافة","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"آخر الأعمال المضافة"}}}}}}