توثيق واجهة برمجة التطبيقات

المصادقة

جميع طلبات API تتطلب مفتاح API في ترويسة الطلب.

Authorization: Bearer YOUR_API_KEY

قائمة الأنمي

الحصول على قائمة كاملة للأنمي:

GET /anime

# مثال الاستجابة
[
    {
        "id": "one-piece",
        "title": "ون بيس",
        "anime_name": "One Piece",
        "image": "https://example.com/one-piece.jpg",
        "anime_url": "https://example.com/anime/one-piece",
        "episodes": [
            {
                "episode_number": 1,
                "episode_url": "https://example.com/one-piece/1",
                "servers": [
                    {
                        "server_name": "Server 1",
                        "quality": "1080p",
                        "url": "https://server1.com/video.mp4"
                    }
                ]
            }
        ]
    }
]

تفاصيل الأنمي

الحصول على تفاصيل أنمي محدد:

GET /anime/details/{anime_id}

# مثال الاستجابة
{
    "id": "one-piece",
    "title": "ون بيس",
    "description": "قصة الفتى مونكي دي لوفي...",
    "genres": ["أكشن", "مغامرة"],
    "status": "مستمر",
    "episodes_count": 1000,
    "rating": 9.5,
    "year": 1999,
    "season": "Fall 1999"
}

البحث

البحث في الويب

GET /search/web/{query}

# مثال الاستجابة
{
    "results": [
        {
            "id": "naruto",
            "title": "ناروتو",
            "image": "https://example.com/naruto.jpg",
            "url": "https://example.com/anime/naruto"
        }
    ],
    "total": 1
}

سيرفرات الحلقات

الحصول على سيرفرات المشاهدة لحلقة محددة:

GET /episode/servers/{episode_id}

# مثال الاستجابة
{
    "episode_id": "one-piece-1089",
    "servers": [
        {
            "name": "Server 1",
            "quality": "1080p",
            "url": "https://server1.com/video.mp4"
        },
        {
            "name": "Server 2",
            "quality": "720p",
            "url": "https://server2.com/video.mp4"
        }
    ]
}

معالجة الأخطاء

رموز الحالة وأنواع الأخطاء:

# أمثلة الأخطاء
400 Bad Request
{
    "error": "معلمات غير صالحة",
    "details": { ... }
}

401 Unauthorized
{
    "error": "مفتاح API غير صالح"
}

404 Not Found
{
    "error": "لم يتم العثور على المحتوى"
}

429 Too Many Requests
{
    "error": "تجاوز حد الطلبات",
    "reset_at": "2024-01-01T00:00:00Z"
}