{"openapi":"3.1.0","info":{"title":"درب — واجهة البيانات العامّة","version":"1.0.0","description":"منصّة تعليمية سعودية تُهيّئ الطالب لاختبارات القدرات والتحصيلي وستيب وبرامج أرامكو، وتساعده على اختيار جامعته وتخصّصه: خريطة مذاكرة، جلسات تركيز، خزنة أخطاء، تقويم دراسي رسمي، ودليل جامعات سعودية بكلياتها وتخصّصاتها.\n\nواجهاتٌ للقراءة فقط، عامّة بلا مصادقة. لا تُعيد أي بيانات شخصية للطلاب. الحقولُ الفارغة تعني «لم تُعلنه الجهة الرسمية بعد» — لا تُملأ تخميناً.","contact":{"name":"درب","url":"https://usedarb.com"},"license":{"name":"Proprietary","url":"https://usedarb.com/terms"}},"servers":[{"url":"https://usedarb.com"}],"tags":[{"name":"universities","description":"قائمة الجامعات السعودية ومعلوماتها؛ ومع `id` تُعاد كلياتها وتخصّصاتها الدقيقة."},{"name":"exams","description":"الاختبارات الوطنية ونوافذ تسجيلها الرسمية وحالتها (مفتوح/قادم/بانتظار الإعلان)."},{"name":"calendar","description":"التقويم الدراسي السعودي المعتمد: الفصول والإجازات ونهاية العام."},{"name":"faq","description":"الأسئلة الشائعة عن القبول الجامعي ومنصّة قبول، مع بحثٍ نصّي عبر `q`."}],"paths":{"/api/agent/universities":{"get":{"tags":["universities"],"operationId":"listUniversities","summary":"قائمة الجامعات السعودية ومعلوماتها؛ ومع `id` تُعاد كلياتها وتخصّصاتها الدقيقة.","parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string"},"description":"معرّف جامعة — يُعيد كلياتها وتخصّصاتها الدقيقة"},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"description":"تصفية بالمنطقة"}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"universities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"region":{"type":["string","null"]},"kind":{"type":["string","null"]},"qsRank":{"type":["integer","null"]},"qsRankTo":{"type":["integer","null"]},"qsYear":{"type":["integer","null"]},"url":{"type":"string"}}}}}}}}}}}},"/api/agent/exams":{"get":{"tags":["exams"],"operationId":"listExams","summary":"الاختبارات الوطنية ونوافذ تسجيلها الرسمية وحالتها (مفتوح/قادم/بانتظار الإعلان).","responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object","properties":{"exams":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/agent/calendar":{"get":{"tags":["calendar"],"operationId":"getCalendar","summary":"التقويم الدراسي السعودي المعتمد: الفصول والإجازات ونهاية العام.","responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object","properties":{"updatedFor":{"type":"string"},"years":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/agent/faq":{"get":{"tags":["faq"],"operationId":"searchFaq","summary":"الأسئلة الشائعة عن القبول الجامعي ومنصّة قبول، مع بحثٍ نصّي عبر `q`.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"بحثٌ نصّي"}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"faq":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/agent/skills":{"get":{"tags":["skills"],"operationId":"listSkills","summary":"اكتشاف المهارات المتاحة للوكلاء","responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object","properties":{"skills":{"type":"array","items":{"type":"object"}}}}}}}}}}},"components":{"securitySchemes":{"googleOAuth":{"type":"oauth2","description":"دخولُ Google عبر Firebase — للوصول إلى ما يخصّ حساب طالبٍ بعينه، بإذنه.","flows":{"authorizationCode":{"authorizationUrl":"https://accounts.google.com/o/oauth2/v2/auth","tokenUrl":"https://oauth2.googleapis.com/token","scopes":{"openid":"الهوية","email":"البريد","profile":"الملف العام"}}}},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Firebase ID token"}}},"security":[]}